Skip to main content
GET
/
v1
/
job-candidates
curl --location --request GET 'https://api.hirempire.com/v1/job-candidates?job_id={job_id}' \
--header 'Authorization: Bearer sk-••••••••••••'

{
  "success": true,
  "total_candidates": 1,
  "candidates": [
    {
      "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

​
job_id
string
required
The unique identifier of the job to retrieve candidates for

​
Authentication

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your API token.
curl --location --request GET 'https://api.hirempire.com/v1/job-candidates?job_id={job_id}' \
--header 'Authorization: Bearer sk-••••••••••••'

​
Response

​
success
boolean
Indicates if the request was successful
​
total_candidates
integer
Total number of candidates for the given job
​
candidates
array
Array of candidate objects
{
  "success": true,
  "total_candidates": 1,
  "candidates": [
    {
      "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 'job_id' is required."
}

​
401 Unauthorized

{
  "success": false,
  "error": "Invalid token"
}

​
404 Not Found

{
  "success": false,
  "error": "Job not found"
}