Candidates

Get candidate

Returns full candidate data including application summaries.

get/candidates/{id}

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/candidates/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Candidate ID (numeric) or alias

Response

Candidate

idinteger required

Unique identifier

aliasstring nullable

Short alphanumeric alias used in profile URLs. Use this to build candidate profile links — https://app.100hires.com/candidate/{alias}. Also accepted as {id} in API requests.

url_backofficestring uri

Absolute backoffice URL of the candidate in the 100Hires recruiter app. Use to render deep-links in agent UIs.

company_idinteger required

ID of the company this candidate belongs to

first_namestring nullable

Candidate's first name

last_namestring nullable

Candidate's last name

emailsstring[] nullable

List of candidate email addresses

phonesstring[] nullable

List of candidate phone numbers

ipstring nullable

IP address from which the candidate applied

created_atinteger required

Unix timestamp (seconds)

updated_atinteger required

Unix timestamp (seconds)

last_message_atinteger nullable

Unix timestamp (seconds) of the most recent message (email or SMS) sent to or received from this candidate. Null if no messages exist.

days_since_last_messageinteger nullable

Number of whole days since the last message. Computed at request time. Null if no messages exist.

Example response

{
  "alias": "dtGeby2",
  "url_backoffice": "https://app.100hires.com/candidate/dtGeby2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.