curl --location --request GET 'https://api.hirempire.com/v1/candidates' \
--header 'Authorization: Bearer sk-••••••••••••'

curl --location --request GET 'https://api.hirempire.com/v1/candidates?type=applicant' \
--header 'Authorization: Bearer sk-••••••••••••'

const response = await fetch('https://api.hirempire.com/v1/candidates', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer sk-••••••••••••' }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.hirempire.com/v1/candidates"
headers = { "Authorization": "Bearer sk-••••••••••••" }
# Optional: filter by type
# params = { "type": "applicant" }

response = requests.get(url, headers=headers)
print(response.json())

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.hirempire.com/v1/candidates',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer sk-••••••••••••'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

print_r(json_decode($response, true));
?>

{
  "success": true,
  "total_candidates": 2,
  "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
    },
    {
      "id": "0c8b5e54-e053-40b2-8c9c-b45ec90acf8a",
      "applied_at": "2026-06-17T09:15:00.000Z",
      "type": "prospect",
      "name": "Sarah Smith",
      "email": "sarah.smith@example.com",
      "phone_number": "+447987654321",
      "linkedin_url": "https://www.linkedin.com/in/sarahsmith",
      "cv_url": null,
      "photo_url": null,
      "source": "Sourcing",
      "status": "qualified",
      "nationality": "United Kingdom",
      "location": "London",
      "experience_years": 8,
      "salary_expectation": null,
      "job_id": null,
      "job_title": null,
      "ai_summary": null,
      "ai_score": null,
      "ai_decision": null,
      "ai_match_percentage": null
    }
  ]
}