WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

Retrieve a job applicant

GET/api/linkedin/gateway/linkedin/jobs/applicants/{applicant_id}

Fetches a single applicant's full profile, experience and screening-question answers by their applicant id.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription
applicant_id *stringThe applicant's id, from List job applicants.

Query parameters

FieldTypeDescription
account_id *stringThe connected account the job posting belongs to.

Response fields

FieldTypeDescription
id / profile_id / public_identifier / public_profile_urlstringThe applicant's LinkedIn identifiers.
name / headline / locationstringBasic profile details.
profile_picture_urlstringThe applicant's profile picture.
applied_atnumberUnix timestamp of the application.
rating"UNRATED" | "GOOD_FIT" | "MAYBE" | "NOT_A_FIT"The rating a member of the hiring team has assigned, if any.
email_address / phone_numberstringTop-level contact fields, mirrored inside contact_info.
contact_infoobjectemail_addresses[] and phone_numbers[] the applicant has on file.
work_experiencearrayPrior roles, each with company, position and a start/end year-month.
educationarraySchools attended, each with degree, field of study and a start/end year-month.
screening_questionsarrayEach posting question paired with the applicant's answers and pass/fail.
This call only reaches applicants on a Classic (non-Recruiter) posting. For a posting published under service=RECRUITER, pull the applicant's details from List job applicants instead.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No applicant with that id was found, or it belongs to a Recruiter posting.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/linkedin/jobs/applicants/6142335890?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "LinkedinJobApplicant",
  "id": "6142335890",
  "profile_id": "ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ",
  "public_identifier": "jane-doe",
  "name": "Jane Doe",
  "headline": "Product Designer at Globex",
  "location": "New York, New York, United States",
  "applied_at": 1767312000,
  "rating": "GOOD_FIT",
  "contact_info": { "email_addresses": ["jane@example.com"], "phone_numbers": [] },
  "work_experience": [
    { "company": "Globex", "position": "Product Designer", "start": { "year": 2022, "month": 3 }, "end": null }
  ],
  "education": [
    { "school": "State University", "degree": "B.A. Design", "start": { "year": 2016, "month": 9 }, "end": { "year": 2020, "month": 5 } }
  ],
  "screening_questions": [
    { "question": "Do you have 5+ years of product design experience?", "answers": ["Yes"], "success": true }
  ]
}
No key yet? Create one from Dashboard → API Keys.