Job Postings
The
JobPosting object represents an external announcement on a job board created by an organization to attract qualified candidates to apply for a specific Job openingProperties
idUUIDremote_idStringThe third-party API ID of the matching object.
created_atDateTime (ISO 8601)The datetime that this object was created by Merge.
modified_atDateTime (ISO 8601)The datetime that this object was modified by Merge.
titleStringThe job posting’s title.
job_posting_urlsUrl[]The Url object is used to represent hyperlinks for a candidate to apply to a given job.
The Url object
The
Url object is used to represent hyperlinks associated with the parent model.Properties
created_atDateTime (ISO 8601)The datetime that this object was created by Merge.
modified_atDateTime (ISO 8601)The datetime that this object was modified by Merge.
valueStringThe site's url.
url_typeEnumThe type of site. Possible values include:
PERSONAL, COMPANY, PORTFOLIO, BLOG, SOCIAL_MEDIA, OTHER, JOB_POSTING. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.remote_was_deletedBooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
jobUUIDID of
Job object for this JobPosting.statusEnumThe job posting's status. Possible values include:
PUBLISHED, CLOSED, DRAFT, INTERNAL, PENDING. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.contentStringThe job posting’s content.
remote_created_atDateTime (ISO 8601)When the third party's job posting was created.
remote_updated_atDateTime (ISO 8601)When the third party's job posting was updated.
is_internalBooleanIndicates whether the job posting is internal or external.
remote_was_deletedBooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
field_mappingsObjectremote_dataRemoteData[]The RemoteData object
The
RemoteData object is used to represent the full data pulled from the third-party API for an object.Properties
pathStringThe third-party API path that is being called.
dataAnyThe data returned from the third-party for this object in its original, unnormalized format.
GET
/job-postings
Betahttps://api.merge.dev/api/ats/v1/job-postings
US
EU
APAC
Returns a list of JobPosting objects.
Query & path parameters
created_afterDateTime (ISO 8601)Optional
If provided, will only return objects created after this datetime.
created_beforeDateTime (ISO 8601)Optional
If provided, will only return objects created before this datetime.
cursorStringOptional
The pagination cursor value.
expandStringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
include_deleted_dataBooleanOptional
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
include_shell_dataBooleanOptional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).
modified_afterDateTime (ISO 8601)Optional
If provided, only objects synced by Merge after this date time will be returned.
modified_beforeDateTime (ISO 8601)Optional
If provided, only objects synced by Merge before this date time will be returned.
page_sizeIntegerOptional
Number of results to return per page. The maximum limit is 100.
remote_idStringOptional
The API provider's ID for the given object.
statusStringOptional
If provided, will only return Job Postings with this status. Options: ('PUBLISHED', 'CLOSED', 'DRAFT', 'INTERNAL', 'PENDING')
Field support by integration
Use the /linked-accounts endpoint to pull platform support information
Ashby
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringtitleString
d.Vinci
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]contentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleString
Dayforce
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_updated_atDateTime (ISO 8601)titleString
Greenhouse
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleString
Greenhouse Job Board API
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringremote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)titleString
iCIMS
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleString
Lever
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleString
Oracle Fusion - Recruiting Cloud
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
is_internalBooleanjobUUIDremote_idStringstatusEnumtitleString
Oracle Taleo
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringstatusEnumtitleString
SAP SuccessFactors
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
contentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)titleString
SmartRecruiters
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleString
Teamtailor
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleString
Traffit
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringcontentStringjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringtitleString
Workable
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleString
Workday
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringtitleStringGET
/job-postings/{id}
Betahttps://api.merge.dev/api/ats/v1/job-postings/{id}
US
EU
APAC
Returns a JobPosting object with the given id.
Query & path parameters
expandStringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
idUUIDRequired
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
include_shell_dataBooleanOptional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).
Field support by integration
Use the /linked-accounts endpoint to pull platform support information
Ashby
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringtitleStringd.Vinci
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]contentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleStringDayforce
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_updated_atDateTime (ISO 8601)titleStringGreenhouse
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleStringGreenhouse Job Board API
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringremote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)titleStringiCIMS
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleStringLever
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleStringOracle Fusion - Recruiting Cloud
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
is_internalBooleanjobUUIDremote_idStringstatusEnumtitleStringOracle Taleo
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringstatusEnumtitleStringSAP SuccessFactors
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
contentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)titleStringSmartRecruiters
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringremote_updated_atDateTime (ISO 8601)statusEnumtitleStringTeamtailor
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleStringTraffit
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringcontentStringjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringtitleStringWorkable
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringremote_created_atDateTime (ISO 8601)remote_dataRemoteData[]pathstringdatastringremote_idStringstatusEnumtitleStringWorkday
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
job_posting_urlsUrl[]valuestringurl_typestringcontentStringis_internalBooleanjobUUIDremote_dataRemoteData[]pathstringdatastringremote_idStringtitleString