curl --location --request GET 'https://api.hirempire.com/v1/get-candidate?candidate_id={candidate_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
{
"success": true,
"candidate": {
"id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"applied_at": "2026-06-18T12:30:00.000Z",
"type": "applicant",
"name": "John Doe",
"email": "john.doe@example.com",
"phone_number": "+15551234567",
"linkedin_url": "https://www.linkedin.com/in/johndoe",
"cv_url": "https://example.com/cv/johndoe.pdf",
"photo_url": "https://example.com/photos/johndoe.jpg",
"source": "LinkedIn",
"status": "shortlisted",
"nationality": "United States",
"location": "San Francisco",
"experience_years": 6,
"salary_expectation": 120000,
"job_id": "f3a2c1d4-1111-4222-9333-444455556666",
"job_title": "Senior Software Engineer",
"ai_summary": "Strong full-stack background, 6 yrs React + Node.",
"ai_score": 85,
"ai_decision": "Shortlist",
"ai_match_percentage": 92
}
}
Candidates
Get a specific candidate
Retrieve a single candidate by candidate ID from your Hirempire workspace
GET
/
v1
/
get-candidate
curl --location --request GET 'https://api.hirempire.com/v1/get-candidate?candidate_id={candidate_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
{
"success": true,
"candidate": {
"id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"applied_at": "2026-06-18T12:30:00.000Z",
"type": "applicant",
"name": "John Doe",
"email": "john.doe@example.com",
"phone_number": "+15551234567",
"linkedin_url": "https://www.linkedin.com/in/johndoe",
"cv_url": "https://example.com/cv/johndoe.pdf",
"photo_url": "https://example.com/photos/johndoe.jpg",
"source": "LinkedIn",
"status": "shortlisted",
"nationality": "United States",
"location": "San Francisco",
"experience_years": 6,
"salary_expectation": 120000,
"job_id": "f3a2c1d4-1111-4222-9333-444455556666",
"job_title": "Senior Software Engineer",
"ai_summary": "Strong full-stack background, 6 yrs React + Node.",
"ai_score": 85,
"ai_decision": "Shortlist",
"ai_match_percentage": 92
}
}
Query Parameters
The unique identifier of the candidate to retrieve
Authentication
Bearer authentication header of the form
Bearer <token>, where <token> is your API token.curl --location --request GET 'https://api.hirempire.com/v1/get-candidate?candidate_id={candidate_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
Response
Indicates if the request was successful
The candidate object
Show Candidate object properties
Show Candidate object properties
Unique identifier for the candidate
ISO 8601 timestamp when the candidate entered the workspace
Candidate sub-type. One of:
applicant (applied to a job), prospect (sourced), upload (manually uploaded)Full name of the candidate
Email address
Phone number
LinkedIn profile URL
URL to the candidate’s CV/resume
URL to the candidate’s photo
Source where the candidate came from
Current pipeline status. One of:
applied screening phone_screen interview technical offer hired rejected withdrawn on_hold shortlisted qualified uploadedCandidate nationality
Candidate location (city)
Years of professional experience
Salary expectation in the workspace’s default currency
ID of the job the candidate is associated with
Title of the associated job
AI-generated summary of the candidate
AI score from 0–100
AI hiring recommendation
Job-to-candidate match percentage
{
"success": true,
"candidate": {
"id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"applied_at": "2026-06-18T12:30:00.000Z",
"type": "applicant",
"name": "John Doe",
"email": "john.doe@example.com",
"phone_number": "+15551234567",
"linkedin_url": "https://www.linkedin.com/in/johndoe",
"cv_url": "https://example.com/cv/johndoe.pdf",
"photo_url": "https://example.com/photos/johndoe.jpg",
"source": "LinkedIn",
"status": "shortlisted",
"nationality": "United States",
"location": "San Francisco",
"experience_years": 6,
"salary_expectation": 120000,
"job_id": "f3a2c1d4-1111-4222-9333-444455556666",
"job_title": "Senior Software Engineer",
"ai_summary": "Strong full-stack background, 6 yrs React + Node.",
"ai_score": 85,
"ai_decision": "Shortlist",
"ai_match_percentage": 92
}
}
Error Responses
400 Bad Request
{
"success": false,
"error": "Query parameter 'candidate_id' is required."
}
{
"success": false,
"error": "Only 'candidate_id' query parameter is allowed."
}
401 Unauthorized
{
"success": false,
"error": "Invalid token"
}
404 Not Found
{
"success": false,
"error": "Candidate not found"
}
Was this page helpful?
⌘I