Get a candidate
Returns the candidate’s identity, contact details, hiring-team assignments, ATS metadata, and anonymization state. For anonymized candidates, PII fields may be redacted; an unknown or out-of-organization ID returns not found.
Authorizations
API tokens are passed as Bearer tokens.
Path Parameters
a candidate ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:can_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"can_a1b2c3d4e5f64789a1b2c3d4e5f64789"
Response
Success
Canonical candidate ID (can_ followed by 32 lowercase hexadecimal UUID characters).
^can_[0-9a-f]{32}$"can_a1b2c3d4e5f64789a1b2c3d4e5f64789"
Additional candidate email addresses. Null means PII was redacted because the candidate is anonymized; an empty array means no additional email addresses.
Candidate phone numbers. Null means PII was redacted because the candidate is anonymized; an empty array means no phone numbers.
ISO 8601 timestamp.
ISO 8601 timestamp.