Get Job Questions

The endpoint will allow you to get the screener and demographic questions configured for a job. These are the questions an applicant answers when applying, and they are the companion to the Create Job Application endpoint.

Resource Path

Property	Value
url	v2/jobs/{id}/questions

Headers

Field	Description
Accept-Language	Language of the result; if none (or an unconfigured one) is provided, the default language will be provided

Parameters

Field	Description
id	the job id

Response

The response is an IndeedQuestion object. It always carries a schemaVersion and groups the questions into two collections: screenerQuestions and demographicQuestions. When a job has no questions configured, the object is returned with only its schemaVersion and no question collections.

Field	Type	Required	Description
schemaVersion	String	Yes	The schema version of the response (for example 1.0).
screenerQuestions	ScreenerQuestions	No	The screener questions the applicant must answer. See ScreenerQuestions Object.
demographicQuestions	DemographicQuestions	No	The demographic questions the applicant may answer. See DemographicQuestions Object.

ScreenerQuestions Object

Field	Type	Required	Description
questions	Array of Question	No	The list of screener questions. See Question Object.

DemographicQuestions Object

Field	Type	Required	Description
questions	Array of Question	No	The list of demographic questions. See Question Object.

Question Object

Field	Type	Required	Description
id	String	No	Unique id of the question.
type	QuestionType	No	The type of the question. See QuestionType Values.
question	String	No	The question text presented to the applicant.
format	String	No	The expected answer format for the question.
required	Boolean	No	Whether an answer is required (true) or optional (false).
min	Integer	No	The minimum value or length accepted for the answer.
max	Integer	No	The maximum value or length accepted for the answer.
options	Array of Option	No	The selectable options for the question. See Option Object.
condition	Condition	No	The condition under which the question is shown. See Condition Object.
qualification	Qualification	No	The qualification rule applied to the answer. See Qualification Object.
hierarchicalOptions	Array of HierarchicalOption	No	The hierarchical (nested) options for the question. See HierarchicalOption Object.
text	String	No	Free-form text content, used by informational questions.

Option Object

Field	Type	Required	Description
label	String	No	The label of the option as it should be displayed.
value	String	No	The value of the option submitted as the answer.

HierarchicalOption Object

Field	Type	Required	Description
id	String	No	Unique id of the hierarchical option.
options	Array of Option	No	The options nested under this hierarchical option. See Option Object.
condition	Condition	No	The condition under which the hierarchical option is shown. See Condition Object.

Condition Object

Field	Type	Required	Description
id	String	No	The id of the question this condition depends on.
value	String	No	The value the dependent question must have for this question to be shown.

Qualification Object

Field	Type	Required	Description
type	String	No	The type of qualification rule.
match	Match	No	The matching rule for the qualification. See Match Object.

Match Object

Field	Type	Required	Description
type	String	No	The type of match (for example how the values are compared).
values	Array of String	No	The values used to evaluate the match.

QuestionType Values

Value	Description
text	A single-line free-text answer.
textarea	A multi-line free-text answer.
select	A single choice among the options.
multiselect	Multiple choices among the options.
hierarchical	A nested choice using hierarchicalOptions.
date	A date answer.
file	A file upload answer.
information	Informational content shown to the applicant, no answer expected.
pagebreak	A page break used to split the questions into pages, no answer expected.

Response Example

{
  "schemaVersion": "1.0",
  "screenerQuestions": {
    "questions": [
      {
        "id": "q1",
        "type": "select",
        "question": "Are you legally authorized to work in Canada?",
        "required": true,
        "options": [
          { "label": "Yes", "value": "yes" },
          { "label": "No", "value": "no" }
        ]
      },
      {
        "id": "q2",
        "type": "text",
        "question": "Years of experience with Java?",
        "format": "number",
        "required": true,
        "min": 0,
        "max": 50
      },
      {
        "id": "q3",
        "type": "hierarchical",
        "question": "Where are you located?",
        "required": false,
        "hierarchicalOptions": [
          {
            "id": "country",
            "options": [
              { "label": "Canada", "value": "CA" },
              { "label": "United States", "value": "US" }
            ]
          },
          {
            "id": "province",
            "options": [
              { "label": "Quebec", "value": "QC" },
              { "label": "Ontario", "value": "ON" }
            ],
            "condition": { "id": "country", "value": "CA" }
          }
        ]
      },
      {
        "id": "q4",
        "type": "information",
        "text": "Please answer the following questions truthfully."
      }
    ]
  },
  "demographicQuestions": {
    "questions": [
      {
        "id": "d1",
        "type": "multiselect",
        "question": "Which of the following describe you? (optional)",
        "required": false,
        "options": [
          { "label": "Veteran", "value": "veteran" },
          { "label": "Person with a disability", "value": "disability" }
        ]
      }
    ]
  }
}

Errors

On success the endpoint returns HTTP 200 OK with the IndeedQuestion body. When the job cannot be resolved, a 404 Not Found is returned.

Status	Meaning
200 OK	The questions were retrieved.
404 Not Found	The id could not be resolved to a job.
500 Internal Server Error	Unexpected processing failure.

{
  "timestamp": "2026-06-14T12:00:00.000+00:00",
  "status": 404,
  "error": "Not Found",
  "message": "Job not found",
  "path": "/v2/jobs/5c875c8b2c17ca56a9806c9f/questions"
}

curl -X GET
  'https://public-api.nextal.com/v2/jobs/{id}/questions?napikey=demo&ntenant=demo'
  -H 'cache-control: no-cache'