List a job's candidates

GET
/jobs/{jobId}/candidates

Tenancy comes from the job in the path: a job you cannot see returns 404 and no candidate query runs at all.

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from Settings > API access, sent as Authorization: Bearer sp_live_.... Send exactly one credential per request; a request carrying both a bearer token and a session cookie is rejected rather than resolved by precedence.

In: header

Path Parameters

jobId*string

Query Parameters

pageNumber?integer

1-based page number.

Range1 <= value
Default1
pageSize?integer

Page size. Clamped server-side, so a very large value returns the maximum.

Range1 <= value
Default20

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/jobs/string/candidates"
{  "currentPage": 0,  "pageSize": 0,  "totalCount": 0,  "data": [    {      "id": "string",      "jobId": "string",      "jobTitle": "string",      "firstName": "string",      "lastName": "string",      "headline": "string",      "stage": "string",      "decision": "string",      "linkedinUrl": "string",      "createdAt": "2019-08-24T14:15:22Z"    }  ]}

Last updated on