Obtenir les questions d’un poste

Ce point de terminaison vous permet d’obtenir les questions de présélection et démographiques configurées pour un poste. Ce sont les questions auxquelles un candidat répond au moment de postuler, et elles sont le complément du point de terminaison Créer une candidature.

Chemin de la ressource

Propriété	Valeur
url	`v2/jobs/{id}/questions`

En-têtes

Champ	Description
Accept-Language	Langue du résultat; si aucune (ou une langue non configurée) n’est fournie, la langue par défaut sera utilisée

Paramètres

Champ	Description
id	l’identifiant du poste

Réponse

La réponse est un objet IndeedQuestion. Elle contient toujours un schemaVersion et regroupe les questions en deux collections : screenerQuestions et demographicQuestions. Lorsqu’un poste n’a aucune question configurée, l’objet est retourné avec seulement son schemaVersion et aucune collection de questions.

Champ	Type	Requis	Description
schemaVersion	String	Oui	La version du schéma de la réponse (par exemple `1.0`).
screenerQuestions	ScreenerQuestions	Non	Les questions de présélection auxquelles le candidat doit répondre. Voir Objet ScreenerQuestions.
demographicQuestions	DemographicQuestions	Non	Les questions démographiques auxquelles le candidat peut répondre. Voir Objet DemographicQuestions.

Objet ScreenerQuestions

Champ	Type	Requis	Description
questions	Array of Question	Non	La liste des questions de présélection. Voir Objet Question.

Objet DemographicQuestions

Champ	Type	Requis	Description
questions	Array of Question	Non	La liste des questions démographiques. Voir Objet Question.

Objet Question

Champ	Type	Requis	Description
id	String	Non	Identifiant unique de la question.
type	QuestionType	Non	Le type de la question. Voir Valeurs QuestionType.
question	String	Non	Le texte de la question présenté au candidat.
format	String	Non	Le format de réponse attendu pour la question.
required	Boolean	Non	Indique si une réponse est obligatoire (`true`) ou facultative (`false`).
min	Integer	Non	La valeur ou longueur minimale acceptée pour la réponse.
max	Integer	Non	La valeur ou longueur maximale acceptée pour la réponse.
options	Array of Option	Non	Les options sélectionnables pour la question. Voir Objet Option.
condition	Condition	Non	La condition sous laquelle la question est affichée. Voir Objet Condition.
qualification	Qualification	Non	La règle de qualification appliquée à la réponse. Voir Objet Qualification.
hierarchicalOptions	Array of HierarchicalOption	Non	Les options hiérarchiques (imbriquées) pour la question. Voir Objet HierarchicalOption.
text	String	Non	Contenu textuel libre, utilisé par les questions informatives.

Objet Option

Champ	Type	Requis	Description
label	String	Non	Le libellé de l’option tel qu’il doit être affiché.
value	String	Non	La valeur de l’option soumise comme réponse.

Objet HierarchicalOption

Champ	Type	Requis	Description
id	String	Non	Identifiant unique de l’option hiérarchique.
options	Array of Option	Non	Les options imbriquées sous cette option hiérarchique. Voir Objet Option.
condition	Condition	Non	La condition sous laquelle l’option hiérarchique est affichée. Voir Objet Condition.

Objet Condition

Champ	Type	Requis	Description
id	String	Non	L’identifiant de la question dont dépend cette condition.
value	String	Non	La valeur que la question dont elle dépend doit avoir pour que cette question soit affichée.

Objet Qualification

Champ	Type	Requis	Description
type	String	Non	Le type de règle de qualification.
match	Match	Non	La règle de correspondance pour la qualification. Voir Objet Match.

Objet Match

Champ	Type	Requis	Description
type	String	Non	Le type de correspondance (par exemple, la façon dont les valeurs sont comparées).
values	Array of String	Non	Les valeurs utilisées pour évaluer la correspondance.

Valeurs QuestionType

Valeur	Description
text	Une réponse textuelle libre sur une seule ligne.
textarea	Une réponse textuelle libre sur plusieurs lignes.
select	Un choix unique parmi les `options`.
multiselect	Plusieurs choix parmi les `options`.
hierarchical	Un choix imbriqué utilisant `hierarchicalOptions`.
date	Une réponse de type date.
file	Une réponse de type téléversement de fichier.
information	Contenu informatif présenté au candidat, aucune réponse attendue.
pagebreak	Un saut de page servant à répartir les questions sur plusieurs pages, aucune réponse attendue.

Exemple de réponse

{
  "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" }
        ]
      }
    ]
  }
}

Erreurs

En cas de succès, le point de terminaison retourne HTTP 200 OK avec le corps IndeedQuestion. Lorsque le poste ne peut être résolu, une réponse 404 Not Found est retournée.

Statut	Signification
`200 OK`	Les questions ont été récupérées.
`404 Not Found`	L’`id` n’a pu être résolu vers un poste.
`500 Internal Server Error`	Échec de traitement inattendu.

{
  "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'