Posting represents a single posting information. A list of Posting objects is returned when using the /postings endpoint.
Example:
{
"id": "75551135",
"uuid": "34225731-e7cf-4584-b0b7-78098fe1a66b",
"name": "Director, Customer Engagement",
"jobAdId": "106f35bc-a0e6-4e55-96f9-56835e3f8349",
"refNumber": "REF12345",
"company": {
"identifier": "smartrecruiters",
"name": "SmartRecruiters Inc"
},
"releasedDate": "2014-02-19T19:36:42.346Z",
"location": {
"city": "San Francisco",
"region": "CA",
"country": "us",
"remote": true,
"latitude": "28.557071",
"longitude": "-81.359463"
},
"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 |
| uuid | string | universally unique string id associated with the posting |
| name | string | name of a job associated with the posting |
| jobAdId | string | id of a job ad |
| refNumber | string | job reference number |
| 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 |