Skip to main content
GET
Get candidate details

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Path Parameters

candidateId
integer
required

The unique identifier of the candidate.

Response

Full candidate details.

Success envelope for the get-candidate-details endpoint.

status
enum<string>
required

Response status ("success").

Available options:
success
data
object
required

Full candidate object as returned by the get-candidate-details endpoint. Identical to the create-candidate response candidate object, plus the state field.