v1
latestOpenAPI 3.0.12026-07-24285462499.1 KBGet a list of postings
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 parameters
List postings <b>created</b> after the specified date.<br/><br/>Date should be in ISO 8601 format: (e.g.: '2015-07-27T08:43:33.000Z').<br/><br/>If no value is provided, only postings created in the last 30 days will be returned.
List of posting statuses separated by comma.<br/><br/>Status definition:<br/><ul><li><b>Pending</b> - 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 <i>PUT</i> method.</li><li><b>UnderPosting</b> - 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.</li><li><b>Active</b> - 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.</li><li><b>toUnpost</b> - 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 <i>Inactive</i> via the <i>PUT</i> method.</li><li><b>Inactive</b> - 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.</li><li><b>Error</b> - this is a status only set by you. It indicates that the posting could not be published. SmartRecruiters will never set this status ourselves.</li></ul><br/>Example: <i>status=Active,Error</i>
Number of elements to skip while processing result.<br/>Allowed range: [0, 2^31-1].
Maximum number of postings returned.<br/>Allowed range: [0, 100].
Response
Postings successfully returned