API Reference

GET Candidate By ID

v1Updated 2026-03-07

GET/api/v1/public/:tenant_slug/candidates/:id

Name	Type	Required	Description
tenant_slug	string	yes	Tenant slug.
id	integer	yes	Candidate ID.

Request


curl -H "Authorization: Bearer <API_KEY>" \
  "http://localhost:3333/api/v1/public/agado-ats/candidates/504"

200 Response


{ "data": { "id": 504, "full_name": "Ana Novak", "headline": "QA Engineer" } }

400 Response


{
  "error": {
    "code": "bad_request",
    "message": "Validation failed for request payload",
    "request_id": "req_123"
  }
}

500 Response


{
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error",
    "request_id": "req_500"
  }
}