Posting

Posting represents a single posting information. A list of Posting objects is returned when using the /postings endpoint.

Example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "id": "75551135",
    "name": "Director, Customer Engagement",
    "company": {
        "identifier": "smartrecruiters",
        "name": "SmartRecruiters Inc"
    },
    "releasedDate": "2014-02-19T19:36:42.346Z",
    "location": {
        "city": "San Francisco",
        "region": "CA",
        "country": "us"
    },
    "industry": {
        "id": "internet",
        "label": "Internet"
    },
    "department": {
        "id": "18554",
        "label": "Marketing",
        "description": "Marketing Department"
    },
    "function": {
        "id": "marketing",
        "label": "Marketing"
    },
    "typeOfEmployment": {
        "label": "Full-time"
    },
    "experienceLevel": {
        "id": "director",
        "label": "Director"
    },
    "customField": [ ],
    "ref": "https://api.smartrecruiters.com/api-v1/companies/smartrecruiters/postings/900155674",
    "creator": {
        "name": "Renette Youssef"
    }
}

Fields description

name type description
id string unique string id associated with the posting
name string name of a job associated with the posting
releasedDate date date when a posting has been released
creator object employee who created a posting. Please check Employee object.
company object company associated with a job. Please check Company object.
industry object industry associated with a job. Please check Industry object and /industries endpoint
department object department associated with a job. Please check Department object.
function object function associated with a job. Please check Function object and /functions endpoint
experienceLevel object experienceLevel associated with a job. Please check ExperienceLevel object and /levels endpoint
typeOfEmployment object experienceLevel associated with this job. Please check TypeOfEmploment object.
location object jobs location. Please see Location object
customField object customField associated with this job. Please see CustomField object
ref string URL pointing endpoint with detailed information about the job