Skip to content

Get applicant

Request

Retrieve an applicant by its id. Returns 404 if the applicant does not exist or belongs to another organization.

Security
bearer-token
Path
idstringrequired

Id of the applicant.

Headers
Checkr-Tenant-Versionstring

CalVer-dated API version to pin behavior to (e.g. 2026-04-29). When omitted, the request is served by the newest supported version. Unknown values return 422.

Value:"2026-04-29"
GET
/applicants/{id}
curl -i -X GET \
  'https://tenant.checkr.com/api/applicants/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Checkr-Tenant-Version: 2026-04-29'

Responses

OK

Bodyapplication/json
idstring

Unique identifier for the applicant record. Use this value in subsequent API calls; it is stable for the lifetime of the applicant. Test-mode IDs carry a _test_ infix (e.g. ap_test_F3hQ7wEsLp2xBnVcRuMyTk); live-mode IDs have no infix.

Example:"ap_F3hQ7wEsLp2xBnVcRuMyTk"
full_namestring, [ 2 .. 100 ] characters

Applicant's full legal name as it appears on government-issued ID.

Example:"Jane Public"
emailstring, (email)

Email address used to contact the applicant about their screening.

Example:"jane@example.com"
first_namestring, [ 1 .. 50 ] characters

Applicant's given name.

last_namestring, [ 1 .. 50 ] characters

Applicant's family name.

dobstring or null, (date)

Date of birth in ISO-8601 format (YYYY-MM-DD). Null if not yet collected.

Example:"1990-05-14"
phone_numberstring or null

Phone number on file for the applicant in E.164 format (US numbers only), or null if none has been collected. Accepted on input in any common format (e.g. (555) 123-4567, 555-123-4567); normalized before storage.

Example:"+15551234567"
ssnstring or null

Masked Social Security Number (last four digits only). Null in responses if no SSN is on file. The full SSN is never returned.

Example:"XXX-XX-6789"
created_atstring, (date-time)

Timestamp the applicant record was created.

Response
{
  "id": "ap_F3hQ7wEsLp2xBnVcRuMyTk",
  "full_name": "Jane Public",
  "email": "jane@example.com",
  "first_name": "string",
  "last_name": "string",
  "dob": "1990-05-14",
  "phone_number": "+15551234567",
  "ssn": "XXX-XX-6789",
  "created_at": "2019-08-24T14:15:22Z"
}