List candidate employments

Candidate employments are the work history entries on a candidate's profile — one row per employer/title the candidate has held. V3 flattens what V1 nested under /v1/candidates/{id}/employments; filter with candidate_ids to retrieve a single candidate's full work history. company_name and title are free-text strings (unlike candidate educations, they are not backed by custom-field option ids). Use latest=true to retrieve only each candidate's most recent employment, which mirrors the company and title shown on the parent candidate record.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

integer
1 to 500
Defaults to 100

Number of results per page

ids
array of integers
length ≤ 50

Comma separated list

ids
created_at
object
updated_at
object
candidate_ids
array of integers
length ≤ 50

Comma separated list

candidate_ids
fields
array of strings
length ≤ 50

Comma separated list of fields to return

fields
boolean

When true, return only each candidate's most recent employment entry; when false, exclude the most recent. Omit to include the full work history.

Response

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json