---
title: "Get candidate screening answers for a candidate's job"
method: GET
path: "/candidates/{id}/jobs/{jobId}/screening-answers"
tags: ["candidates"]
---

# Get candidate screening answers for a candidate's job

`GET /candidates/{id}/jobs/{jobId}/screening-answers`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/candidates/{id}/jobs/{jobId}/screening-answers`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `candidates_read`

Returns candidate screening question answers for a candidate's job. Returns an empty array when there is no screening answers for given candidate's job.

UUID in question category indicates custom question. Other value indicates predefined library question.

In order to create human readable format of answers please use label properties. Ignore labels for answers with single field.
Based on labels from included example you can get following text:

```text
Do you have a current driver's license?
 - No

Free text question
 - Long text answer for free text questions

Checkbox question
 - Confirmed

Legacy acknowledgment question - replaced by checkbox
 - Confirmed

Gender, Race and Ethnicity [(definitions)](https://smartrecruiters.com/oneclick/static/html/en/eeoGeneral.html)
 - Gender: Male
 - Race/Ethnicity: Prefer not to answer

Currency question
 - 1234

Multiple choice dropdown
 - third value, second value, first value

Languages
 1)
 - Language: English
 - Proficiency level: Advanced
 2)
 - Language: Spanish
 - Proficiency level: Beginner
 3)
 - Language: French
 - Proficiency level: Intermediate

What are your preferred work shifts?
1)
 - Day: Weekdays
 - From: 08:00 AM
 - To: 04:00 PM
2)
 - Day: Weekdays
 - From: 10:00 AM
 - To: 02:00 PM

Your Name
 - John
```

## Response `200`

Candidate screening question answers for a candidate's job

- ScreeningAnswers
  - `totalFound` integer, required
  - `content` ScreeningAnswer[], required
    - `id` string, required: Id of Question to which answer was responded
    - `type` 'text' | 'checkbox' | 'languages' | 'acknowledgement' | 'textarea' | 'select' | 'files' | 'info' | 'eeo' | 'radio' | 'salaryExpectation' | 'currency' | 'work_shifts', required
    - `category` string, required: UUID for custom questions or fixed value for predefined questions: - eeoInformation - ofccpDisability - ofccpVeteransForm - veteranStatus - disabilityStatus - ofccpReasonableAccommodation - ethnicity - ethnicGroupsDescriptions - todaysDate - yourName - preferredWorkShifts - languages - previousEmployment - drivingRevoked - drivingCurrent - criminalRecord - workPermit
    - `name` string, required: Question name visible to administrator on questions library list
    - `label` string, required: Question text shown to candidate
    - `records` AnswerRecord[], required: Multiple records may be used for example for questions (Preferred Work Shifts, Languages)
      - `fields` AnswerField[], required: Multiple fields may be used for example for questions (Preferred Work Shifts, Languages, EEO, Currency)
        - `id` string, required
        - `label` string: Field label shown to candidate - ignore when empty
        - `values` AnswerFieldValue[], required: Multiple values may be used for example for Multiselect Dropdown question
          - `id` string, required: Value text or value ID - depends on question definition
          - `label` string, required: Value text shown to candidate

## Other responses

- `403`: Screening Question Answers access forbidden
- `404`: Screening Question Answers not found

---

[API](https://skmtc.dev/smartrecruiters/apis/candidates-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/candidates-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/candidates-api/revisions/8fde9b33d46d?raw)