Jobs
The Job object can be used to track any jobs that are currently or will be open/closed for applications.
Properties

idUUID
Required

remote_idString
Optional
The third-party API ID of the matching object.

created_atDateTime (ISO 8601)
Required
The datetime that this object was created by Merge.

modified_atDateTime (ISO 8601)
Required
The datetime that this object was modified by Merge.

nameString
Optional
The job's name.

descriptionString
Optional
The job's description.

codeString
Optional
The job's code. Typically an additional identifier used to reference the particular job that is displayed on the ATS.

statusEnum
Optional
The job's status. Possible values include: OPEN, CLOSED, DRAFT, ARCHIVED, PENDING. In cases where there is no clear mapping, the original value passed through will be returned.

typeEnum
Optional
The job's type. Possible values include: POSTING, REQUISITION, PROFILE. In cases where there is no clear mapping, the original value passed through will be returned.

job_postingsArray
Required
IDs of JobPosting objects that serve as job postings for this Job.

job_posting_urlsUrl[]
Required
The Url object
The Url object is used to represent hyperlinks associated with the parent model.
Properties

created_atDateTime (ISO 8601)
Required
The datetime that this object was created by Merge.

modified_atDateTime (ISO 8601)
Required
The datetime that this object was modified by Merge.

valueString
Optional
The site's url.

url_typeEnum
Optional
The 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.

remote_created_atDateTime (ISO 8601)
Optional
When the third party's job was created.

remote_updated_atDateTime (ISO 8601)
Optional
When the third party's job was updated.

confidentialBoolean
Optional
Whether the job is confidential.

departmentsArray
Required
IDs of Department objects for this Job.

officesArray
Required
IDs of Office objects for this Job.

hiring_managersArray
Required
IDs of RemoteUser objects that serve as hiring managers for this Job.

recruitersArray
Required
IDs of RemoteUser objects that serve as recruiters for this Job.

remote_was_deletedBoolean
Required
Indicates whether or not this object has been deleted in the third party platform.

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional


GET
/jobs

https://api.merge.dev/api/ats/v1/jobs

US
EU

Returns a list of Job objects.


Query & Path Parameters

codeString
Optional
If provided, will only return jobs with this code.

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.

cursorString
Optional
The pagination cursor value.

expandString
Optional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

include_deleted_dataBoolean
Optional
Whether to include data that was marked as deleted by third party webhooks.

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

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.

officesString
Optional
If provided, will only return jobs for this office; multiple offices can be separated by commas.

page_sizeInteger
Optional
Number of results to return per page.

remote_fieldsString
Optional
Deprecated. Use show_enum_origins.

remote_idString
Optional
The API provider's ID for the given object.

show_enum_originsString
Optional
A comma separated list of enum field names for which you'd like the original values to be returned, instead of Merge's normalized enum values. Learn more

statusString
Optional
If provided, will only return jobs with this status. Options: ('OPEN', 'CLOSED', 'DRAFT', 'ARCHIVED', 'PENDING')

Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
ApplicantStack
ApplicantStack
Ashby
Ashby
Avature
Avature
BambooHR
BambooHR
Breezy
Breezy
Bullhorn
Bullhorn
CATS
CATS
ClayHR
ClayHR
Clockwork
Clockwork
Comeet
Comeet
Cornerstone TalentLink
Cornerstone TalentLink
EngageATS
EngageATS
Eploy
Eploy
Fountain
Fountain
Freshteam
Freshteam
Greenhouse
Greenhouse
Greenhouse - Job Boards API
Greenhouse - Job Boards API
Harbour ATS
Harbour ATS
Homerun
Homerun
HR Cloud
HR Cloud
iCIMS
iCIMS
Infinite BrassRing
Infinite BrassRing
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
JobScore
JobScore
Jobsoid
Jobsoid
Jobvite
Jobvite
Join
Join
Lever
Lever
Occupop
Occupop
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Personio Recruiting
Personio Recruiting
Pinpoint
Pinpoint
Polymer
Polymer
Recruiterflow
Recruiterflow
Recruitive
Recruitive
Sage HR
Sage HR
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
TalentLyft
TalentLyft
TalentReef
TalentReef
Teamtailor
Teamtailor
Tellent
Tellent
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Workable
Workable
Workday
Workday
Zoho Recruit
Zoho Recruit
GET
/jobs/{id}

https://api.merge.dev/api/ats/v1/jobs/{id}

US
EU

Returns a Job object with the given id.


Query & Path Parameters

expandString
Optional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

idUUID
Required

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

remote_fieldsString
Optional
Deprecated. Use show_enum_origins.

show_enum_originsString
Optional
A comma separated list of enum field names for which you'd like the original values to be returned, instead of Merge's normalized enum values. Learn more

Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
ApplicantStack
ApplicantStack
Ashby
Ashby
Avature
Avature
BambooHR
BambooHR
Breezy
Breezy
Bullhorn
Bullhorn
CATS
CATS
ClayHR
ClayHR
Clockwork
Clockwork
Comeet
Comeet
Cornerstone TalentLink
Cornerstone TalentLink
EngageATS
EngageATS
Eploy
Eploy
Fountain
Fountain
Freshteam
Freshteam
Greenhouse
Greenhouse