Get a list of postings

get

https://api.smartrecruiters.com/feed/publications

Get job postings published to your job board.
You must pass authentication token through X-SmartToken HTTP header.

By default, this endpoint will return only postings created in the last 30 days with the status Pending. Use additional parameters to control which postings are returned.

Query Params

updatedAfter

string

List postings created after the specified date.

Date should be in ISO 8601 format: (e.g.: '2015-07-27T08:43:33.000Z').

If no value is provided, only postings created in the last 30 days will be returned.

status

array of strings

List of posting statuses separated by comma.

Status definition:

Pending - this is a new posting that is pending publication on your job board. You should always retrieve these postings, publish them, and then update the status via the PUT method.
UnderPosting - this is a status that is only set by you. It indicates that a posting is currently being published but is not yet available on the job board. SmartRecruiters will never set this status ourselves.
Active - this is a status that is only set by you. It indicates that the posting has been successfully published and is available on the job board. SmartRecruiters will never set this status ourselves.
toUnpost - this posting has either expired or has manually been requested for removal by the client. As a job board, you should unpost these postings immediately, and then update the status to Inactive via the PUT method.
Inactive - this is a status that is only set by you. It indicates that the posting has been successfully unpublished and is no longer available on the job board. SmartRecruiters will never set this status ourselves.
Error - this is a status only set by you. It indicates that the posting could not be published. SmartRecruiters will never set this status ourselves.

Example: status=Active,Error

status

offset

string

≥ 0

Number of elements to skip while processing result.
Allowed range: [0, 2^31-1].

limit

string

0 to 100

Maximum number of postings returned.
Allowed range: [0, 100].

Responses

200Postings successfully returned

401Unauthorized

404Not found