> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Récupérer un questionnaire KYC : API Didit > Récupérez le détail d'un questionnaire KYC Didit : questions ordonnées, options et libellés multilingues. Gestion programmatique, facturation à l'appel. Prompt de l'API de récupération d'un questionnaire Copier le prompt dans le presse-papiers \

\`Fetch the full configuration of a single Didit questionnaire through the Management API.

Endpoint:
GET https://verification.didit.me/v3/questionnaires/{questionnaire_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Retrieve the questionnaire definition (form_elements, languages, translations, internal graph) so I can render a preview, debug a session, or audit changes.

Path parameter:
\- questionnaire_uuid — the per-version questionnaire UUID returned by GET /v3/questionnaires/ or POST /v3/questionnaires/. Each version has its own primary key; questionnaire_group_id is the stable id shared by every version.

Example call:
curl -X GET "https://verification.didit.me/v3/questionnaires/{questionnaire_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- title — internal questionnaire name.
\- languages and default_language — supported locales for translations.
\- form_elements — ordered question definitions including element_type, label, options, is_required.
\- graph — internal graph built from form_elements (do not edit manually; use the simple form_elements shape on PATCH).
\- status — "draft" or "published"; only drafts are editable.

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope when the questionnaire belongs to a different application than the API key.
\- 404 — questionnaire not found in this application.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Coller dans ## OpenAPI ````yaml fr/openapi-25.json GET /v3/questionnaires/{questionnaire_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/{questionnaire_uuid}/: get: tags: - Questionnaires summary: Obtenir le questionnaire description: >- Récupérer le détail complet du questionnaire pour une version par `questionnaire_uuid` : titre, `languages`, `graph` canonique, `sections` dérivées et métadonnées de version. operationId: get_questionnaire parameters: - name: questionnaire_uuid in: path required: true schema: type: string format: uuid description: >- UUID par version du questionnaire (la valeur `uuid` renvoyée par l'endpoint de liste, également renvoyée sous `questionnaire_id` sur les endpoints de détail). responses: '200': description: >- Détails complets du questionnaire incluant le `graph` canonique, la vue dérivée `sections`, les métadonnées de version et `is_editable`. content: application/json: schema: $ref: '#/components/schemas/QuestionnaireDetail' examples: Published questionnaire: value: questionnaire_id: 11111111-2222-3333-4444-555555555555 title: Customer Onboarding description: Additional information needed for verification languages: - en default_language: en is_active: true is_simple_questionnaire: true graph: start_node: occupation nodes: occupation: element_type: SHORT_TEXT is_required: true title: en: What is your occupation? next: source_of_funds source_of_funds: element_type: MULTIPLE_CHOICE is_required: true title: en: Source of funds choices: - value: employment label: en: Employment - value: business label: en: Business next: null sections: - title: {} description: {} items: - uuid: 11111111-2222-3333-4444-666666666666 value: occupation element_type: SHORT_TEXT is_required: true title: en: What is your occupation? questionnaire_group_id: 11111111-2222-3333-4444-555555555555 version: 1 status: published published_at: '2026-04-23T10:00:00Z' is_editable: false '403': description: >- Clé API manquante, mal formée, expirée ou limitée à une application différente. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '404': description: >- Aucun questionnaire avec ce `questionnaire_uuid` n'existe pour l'application authentifiée. Soit l'UUID est incorrect, soit il appartient à une autre application — l'API ne fait délibérément pas la distinction entre les deux cas. content: application/json: examples: Not found: value: detail: Not found. '429': description: >- Limite de débit dépassée. Réessayez avec une temporisation exponentielle. '500': description: Erreur serveur inattendue. Peut être réessayé en toute sécurité. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: >- curl -X GET 'https://verification.didit.me/v3/questionnaires/11111111-2222-3333-4444-555555555555/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.questionnaires.retrieve( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.questionnaires.retrieve("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Questionnaires.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.questionnaires().retrieve("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- questionnaires->retrieve('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.questionnaires.retrieve("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Questionnaires.RetrieveAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: QuestionnaireDetail: type: object description: >- Détails complets du questionnaire renvoyés par les endpoints GET, POST (création) et PATCH (mise à jour). properties: questionnaire_id: type: string format: uuid description: >- Identifiant unique du questionnaire. Utilisez cet identifiant pour faire référence au questionnaire depuis un workflow ou lors de requêtes ultérieures de mise à jour ou de suppression. title: type: string description: type: string nullable: true languages: type: array items: type: string default_language: type: string is_active: type: boolean is_simple_questionnaire: type: boolean graph: type: object description: >- Structure en graphe avec start_node et la table de correspondance des nœuds. sections: type: array description: Contenu du questionnaire regroupé en sections (dérivé du graphe). items: type: object questionnaire_group_id: type: string format: uuid description: >- Identifiant stable qui regroupe toutes les versions du même questionnaire. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: >- Vrai lorsque le questionnaire peut encore être modifié directement (versions brouillon). securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.