Candidates
Get candidate by id
Getting Started
Endpoints
- Applications
- Candidates
- Candidate object
- GETGet candidates
- GETGet candidate by id
- PUTUpdate candidate
- Candidate Notes
- Candidate Tags
- Jobs
- Feedback
- Interviews
- Users
- Files
- Settings
- Webhooks
Webhooks
Candidates
Get candidate by id
Get a candidate by id
GET
/
v1.0
/
{company_id}
/
candidates
/
{candidate_id}
curl --request GET \
--url https://api.hirehive.com/v1.0/{company_id}/candidates/{candidate_id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "<string>",
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"phone_number": "<string>",
"title": "<string>",
"company": "<string>",
"location": {
"address": "<string>",
"country": {
"name": "<string>",
"code": "<string>"
}
},
"image_url": "<string>",
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"rating": 123,
"application_ids": [
"<string>"
],
"social_profiles": [
{
"type": "linked_in",
"uri": "<string>"
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Response
200
application/json
The first name of the candidate.
Minimum length:
1
The last name of the candidate.
Minimum length:
1
The id of the candidate, format can_abc123
.
The full name of the candidate.
The email address of the candidate.
The phone number of the candidate.
The current job title of the candidate.
The current company of the candidate.
An image url to a profile picture
A 1-5 star rating assigned to the candidate.
A list of other application ids this candidate may have. Format app_abc123
.
Was this page helpful?
curl --request GET \
--url https://api.hirehive.com/v1.0/{company_id}/candidates/{candidate_id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "<string>",
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"phone_number": "<string>",
"title": "<string>",
"company": "<string>",
"location": {
"address": "<string>",
"country": {
"name": "<string>",
"code": "<string>"
}
},
"image_url": "<string>",
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"rating": 123,
"application_ids": [
"<string>"
],
"social_profiles": [
{
"type": "linked_in",
"uri": "<string>"
}
]
}
}