Skip to Content
API Reference

GET List Candidates

v1Updated 2026-03-07

Get candidates

Scopescandidates:read / candidates:write
GET/api/v1/public/:tenant_slug/candidates
NameTypeRequiredDescription
tenant_slugstringyesTenant slug.
pageintegernoDefault 1.
per_pageintegernoDefault 25.
sortstringnoExample: -updated_at.
filter[recruiter_id]integernoFilter by recruiter.
filter[q]stringnoSearch by full name.
Request
curl -H "Authorization: Bearer <API_KEY>" \ "http://localhost:3333/api/v1/public/agado-ats/candidates?filter[q]=Ana"
200 Response
{ "data": [{ "id": 504, "full_name": "Ana Novak", "headline": "QA Engineer", "source_id": 22 }], "meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 } }
400 Response
{ "error": { "code": "bad_request", "message": "Validation failed for request payload", "request_id": "req_123" } }
401 Response
{ "error": { "code": "unauthorized", "message": "Missing or invalid API key", "request_id": "req_401" } }
403 Response
{ "error": { "code": "forbidden", "message": "API key does not have required scope", "request_id": "req_403" } }
404 Response
{ "error": { "code": "not_found", "message": "Resource was not found", "request_id": "req_404" } }
500 Response
{ "error": { "code": "internal_error", "message": "Unexpected server error", "request_id": "req_500" } }