Candidates
The Candidate object is used to represent profile information about a given Candidate. Because it is specific to a Candidate, this information stays constant across 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.

first_nameString
Optional
The candidate's first name.

last_nameString
Optional
The candidate's last name.

companyString
Optional
The candidate's current company.

titleString
Optional
The candidate's current title.

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

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

last_interaction_atDateTime (ISO 8601)
Optional
When the most recent interaction with the candidate occurred.

is_privateBoolean
Optional
Whether or not the candidate is private.

can_emailBoolean
Optional
Whether or not the candidate can be emailed.

locationsArray
Optional
The candidate's locations.

phone_numbersPhoneNumber[]
Required
The PhoneNumber object
The PhoneNumber object is used to represent a candidate's phone number.
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 phone number.

phone_number_typeEnum
Optional
The type of phone number. Possible values include: HOME, WORK, MOBILE, SKYPE, OTHER. 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_deletedBoolean
Required
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.

email_addressesEmailAddress[]
Required
The EmailAddress object
The EmailAddress object is used to represent a candidate's email address.
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 email address.

email_address_typeEnum
Optional
The type of email address. Possible values include: PERSONAL, WORK, OTHER. 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_deletedBoolean
Required
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.

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. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.

remote_was_deletedBoolean
Required
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.

tagsArray
Required
Array of Tag names as strings.

applicationsApplication[]
Required
Array of Application object IDs.
The Application object
The Application Object is used to represent a candidate's journey through a particular Job's recruiting process. If a Candidate applies for multiple Jobs, there will be a separate Application for each Job if the third-party integration allows it.
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.

candidateUUID
Optional
The candidate applying.

jobUUID
Optional
The job being applied for.

applied_atDateTime (ISO 8601)
Optional
When the application was submitted.

rejected_atDateTime (ISO 8601)
Optional
When the application was rejected.

offersArray
Required

sourceString
Optional
The application's source.

credited_toUUID
Optional
The user credited for this application.

screening_question_answersScreeningQuestionAnswer[]
Required

current_stageUUID
Optional
The application's current stage.

reject_reasonUUID
Optional
The application's reason for rejection.

remote_was_deletedBoolean
Required
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.

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional

attachmentsAttachment[]
Required
Array of Attachment object IDs.
The Attachment object
The Attachment object is used to represent a file attached to a candidate.
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.

file_nameString
Optional
The attachment's name.

file_urlString
Optional
The attachment's url.

candidateUUID
Optional

attachment_typeEnum
Optional
The attachment's type. Possible values include: RESUME, COVER_LETTER, OFFER_LETTER, OTHER. 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_deletedBoolean
Required
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.

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional

remote_was_deletedBoolean
Required
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.

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional


GET
/candidates

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

US
EU
APAC

Returns a list of Candidate 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.

cursorString
Optional
The pagination cursor value.

email_addressesString
Optional
If provided, will only return candidates with these email addresses; multiple addresses can be separated by commas.

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

first_nameString
Optional
If provided, will only return candidates with this first name.

include_deleted_dataBoolean
Optional
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_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

include_shell_dataBoolean
Optional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).

last_nameString
Optional
If provided, will only return candidates with this last name.

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_sizeInteger
Optional
Number of results to return per page.

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

tagsString
Optional
If provided, will only return candidates with these tags; multiple tags can be separated by commas.

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
Easycruit
Easycruit
EngageATS
EngageATS
Eploy
Eploy
Fountain
Fountain
Gem
Gem
Greenhouse
Greenhouse
Harbour ATS
Harbour ATS
Homerun
Homerun
HR Cloud
HR Cloud
iCIMS
iCIMS
Infinite BrassRing
Infinite BrassRing
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
JobScore
JobScore
Jobvite
Jobvite
Join
Join
Lano
Lano
Lever
Lever
Manatal
Manatal
Occupop
Occupop
Onlyfy
Onlyfy
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Pinpoint
Pinpoint
Recruiterflow
Recruiterflow
Recruitive
Recruitive
Sage HR
Sage HR
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
Taleez
Taleez
TalentLyft
TalentLyft
Teamtailor
Teamtailor
Tellent
Tellent
Traffit
Traffit
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Welcome to the Jungle
Welcome to the Jungle
Workable
Workable
Workday
Workday
Zoho Recruit
Zoho Recruit
TalentReef
TalentReef
Coming soon
POST
/candidates

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

US
EU
APAC

Creates a Candidate object with the given values.


Query & Path Parameters

is_debug_modeBoolean
Optional
Whether to include debug fields (such as log file links) in the response.

run_asyncBoolean
Optional
Whether or not third-party updates should be run asynchronously.
Body Parameters

modelObject
Required
Find available fields below under “Model Parameters”.

remote_user_idString
Required
Model Parameters
View app-specific writable fields under “Field support by platform” in this section.

first_nameString
The candidate's first name.

last_nameString
The candidate's last name.

companyString
The candidate's current company.

titleString
The candidate's current title.

last_interaction_atDateTime (ISO 8601)
When the most recent interaction with the candidate occurred.

is_privateBoolean
Whether or not the candidate is private.

can_emailBoolean
Whether or not the candidate can be emailed.

locationsArray
The candidate's locations.

phone_numbersArray

email_addressesArray

urlsArray

tagsArray
Array of Tag names as strings.

applicationsArray
Array of Application object IDs.

attachmentsArray
Array of Attachment object IDs.

remote_template_idString

integration_paramsObject

linked_account_paramsObject

Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
Ashby
Ashby
Avature
Avature
BambooHR
BambooHR
Breezy
Breezy
Bullhorn
Bullhorn
Clockwork
Clockwork
Comeet
Comeet
Cornerstone TalentLink
Cornerstone TalentLink
Eploy
Eploy
Fountain
Fountain
Greenhouse
Greenhouse
Harbour ATS
Harbour ATS
iCIMS
iCIMS
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
Jobvite
Jobvite
Lever
Lever
Occupop
Occupop
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Pinpoint
Pinpoint
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
Taleez
Taleez
TalentReef
TalentReef
Teamtailor
Teamtailor
Tellent
Tellent
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Workable
Workable
Workday
Workday
Homerun
Homerun
Coming soon
To include the correct model fields when making POST requests, use the GET /candidates/meta/post endpoint. Learn more in our /meta guide.
GET
/candidates/{id}

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

US
EU
APAC

Returns a Candidate 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.
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
Easycruit
Easycruit
EngageATS
EngageATS
Eploy
Eploy
Fountain
Fountain
Gem
Gem
Greenhouse
Greenhouse
Harbour ATS
Harbour ATS
Homerun
Homerun
HR Cloud
HR Cloud
iCIMS
iCIMS
Infinite BrassRing
Infinite BrassRing
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
JobScore
JobScore
Jobvite
Jobvite
Join
Join
Lano
Lano
Lever
Lever
Manatal
Manatal
Occupop
Occupop
Onlyfy
Onlyfy
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Pinpoint
Pinpoint
Recruiterflow
Recruiterflow
Recruitive
Recruitive
Sage HR
Sage HR
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
Taleez
Taleez
TalentLyft
TalentLyft
Teamtailor
Teamtailor
Tellent
Tellent
Traffit
Traffit
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Welcome to the Jungle
Welcome to the Jungle
Workable
Workable
Workday
Workday
Zoho Recruit
Zoho Recruit
TalentReef
TalentReef
Coming soon
PATCH
/candidates/{id}
Beta

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

US
EU
APAC

Updates a Candidate object with the given id.


Query & Path Parameters

idUUID
Required

is_debug_modeBoolean
Optional
Whether to include debug fields (such as log file links) in the response.

run_asyncBoolean
Optional
Whether or not third-party updates should be run asynchronously.
Body Parameters

modelObject
Required
Find available fields below under “Model Parameters”.

remote_user_idString
Required
Model Parameters
View app-specific writable fields under “Field support by platform” in this section.

first_nameString
The candidate's first name.

last_nameString
The candidate's last name.

companyString
The candidate's current company.

titleString
The candidate's current title.

last_interaction_atDateTime (ISO 8601)
When the most recent interaction with the candidate occurred.

is_privateBoolean
Whether or not the candidate is private.

can_emailBoolean
Whether or not the candidate can be emailed.

locationsArray
The candidate's locations.

phone_numbersArray

email_addressesArray

urlsArray

tagsArray
Array of Tag names as strings.

applicationsArray
Array of Application object IDs.

attachmentsArray
Array of Attachment object IDs.

remote_template_idString

integration_paramsObject

linked_account_paramsObject

Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
Ashby
Ashby
Greenhouse
Greenhouse
JobAdder
JobAdder
Lever
Lever
SmartRecruiters
SmartRecruiters
POST
/candidates/ignore/{model_id}

https://api.merge.dev/api/ats/v1/candidates/ignore/{model_id}

US
EU
APAC

Ignores a specific row based on the model_id in the url. These records will have their properties set to null, and will not be updated in future syncs. The "reason" and "message" fields in the request body will be stored for audit purposes.


Query & Path Parameters

model_idUUID
Required
Body Parameters

reasonEnum
Required
Must pass in one of the following choices: GENERAL_CUSTOMER_REQUEST, GDPR, OTHER.

messageString
Required
Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
Ashby
Ashby
Avature
Avature
BambooHR
BambooHR
Breezy
Breezy
Bullhorn
Bullhorn
Clockwork
Clockwork
Comeet
Comeet
Cornerstone TalentLink
Cornerstone TalentLink
Eploy
Eploy
Fountain
Fountain
Greenhouse
Greenhouse
Harbour ATS
Harbour ATS
iCIMS
iCIMS
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
Jobvite
Jobvite
Lever
Lever
Occupop
Occupop
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Pinpoint
Pinpoint
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
Taleez
Taleez
TalentReef
TalentReef
Teamtailor
Teamtailor
Tellent
Tellent
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Workable
Workable
Workday
Workday
Homerun
Homerun
Coming soon
GET
/candidates/meta/patch/{id}

https://api.merge.dev/api/ats/v1/candidates/meta/patch/{id}

US
EU
APAC

Returns metadata for Candidate PATCHs.


Query & Path Parameters

idUUID
Required
Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
Ashby
Ashby
Greenhouse
Greenhouse
JobAdder
JobAdder
Lever
Lever
SmartRecruiters
SmartRecruiters
GET
/candidates/meta/post

https://api.merge.dev/api/ats/v1/candidates/meta/post

US
EU
APAC

Returns metadata for Candidate POSTs.


Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
Ashby
Ashby
Avature
Avature
BambooHR
BambooHR
Breezy
Breezy
Bullhorn
Bullhorn
Clockwork
Clockwork
Comeet
Comeet
Cornerstone TalentLink
Cornerstone TalentLink
Eploy
Eploy
Fountain
Fountain
Greenhouse
Greenhouse
Harbour ATS
Harbour ATS
iCIMS
iCIMS
JazzHR
JazzHR
JobAdder
JobAdder
JobDiva
JobDiva
Jobvite
Jobvite
Lever
Lever
Occupop
Occupop
Oracle Fusion - Recruiting Cloud
Oracle Fusion - Recruiting Cloud
Oracle Taleo
Oracle Taleo
Pinpoint
Pinpoint
SAP SuccessFactors
SAP SuccessFactors
SmartRecruiters
SmartRecruiters
Taleez
Taleez
TalentReef
TalentReef
Teamtailor
Teamtailor
Tellent
Tellent
Tribepad
Tribepad
UKG Pro Recruiting
UKG Pro Recruiting
Workable
Workable
Workday
Workday
Homerun
Homerun
Coming soon