List candidates
GET
/candidates
Filters
job_id: limit results to candidates associated with one job.status: filter by that job's candidate stage. Requires job_id.updated_since: filter by the candidate profile's update time.GET /jobs/{jobId}/candidate-stages; they are not job lifecycle codes.Permissions
candidates.readPagination
page and pageSize; see the query parameters below for defaults and limits. See Pagination & filtering for examples.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.cvviz.com/v1/candidates?page=&pageSize=&job_id=&status=&updated_since=' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success
{
"data": [
{
"resume": {
"fileName": "Asha_Sharma_Resume.pdf",
"downloadUrl": "https://api.cvviz.com/v1/candidates/501/resume/download"
},
"currentCompany": "Example Company",
"currentJobTitle": "Backend Engineer",
"phoneCountryCode": "91",
"professionalProfiles": {
"linkedin": null,
"github": null
},
"noticePeriod": {
"value": 1,
"unit": "M"
},
"id": 501,
"originalJobId": 901,
"jobContext": {
"jobId": 901,
"status": 3
},
"firstName": "Asha",
"lastName": "Sharma",
"email": "asha.sharma@example.com",
"phone": "+919876543210",
"source": "Career page",
"experienceMonths": 48,
"qualifications": [
"Bachelor's degree"
],
"skills": [
"TypeScript",
"Node.js",
"MySQL"
],
"currentLocation": {
"city": "Pune",
"state": "Maharashtra",
"country": "India"
},
"createdAt": "2026-08-20T08:15:00.000Z",
"updatedAt": "2026-08-30T15:20:00.000Z"
}
],
"meta": {
"pagination": {
"page": 1,
"pageSize": 10,
"totalItems": 1,
"totalPages": 1
}
}
}