---
title: "Get an applicant"
method: POST
path: "/v1/actions/get_job_applicant"
tags: ["Jobs"]
---

# Get an applicant

`POST /v1/actions/get_job_applicant`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/get_job_applicant`
- Auth: HTTP bearer

Read one applicant, with their answers to the screening questions.

Ordinary (CLASSIC) job postings only.

Docs: https://heyreagent.com/docs/actions/get_job_applicant

## Request body

- object
  - `applicantId` string, required: The applicant id (from list_job_applicants).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: id, profileId, publicIdentifier, publicProfileUrl, name, location, headline, profilePictureUrl, appliedAt, rating, hiringState, emailAddress, phoneNumber, contactInfo.emailAddresses, contactInfo.phoneNumbers, workExperience[].company, workExperience[].companyId, workExperience[].position, workExperience[].location, workExperience[].description, workExperience[].pictureUrl, education[].school, education[].schoolId, education[].degree, education[].description, education[].fieldOfStudy, education[].pictureUrl, screeningQuestions[].question, screeningQuestions[].answers, screeningQuestions[].success.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)