> ## 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. # API de liste des questionnaires : formulaires KYC > Récupérez tous les questionnaires KYC et formulaires de conformité de votre organisation Didit en un seul appel. Gestion programmatique, facturation à l'appel. Prompt de l'API pour lister les questionnaires Copier le prompt dans le presse-papiers \

\`List every Didit questionnaire (custom form) defined for my application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/questionnaires/

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

Goal:
\- Retrieve every questionnaire so I can render a picker in my back-office, sync ids into my config, or discover the questionnaire_id of a form created in the Console.
\- Use the returned questionnaire_id later as config.questionnaire_uuid on a QUESTIONNAIRE feature in a workflow (see POST /v3/workflows/).

Behavior:
\- Results are returned newest first (-created_at). The endpoint does not paginate today — all rows are returned in one response.
\- Each row is one version of a questionnaire group. questionnaire_group_id is the stable identifier shared by every version; version is the integer version number; status is "draft" or "published".
\- Workflows that reference a questionnaire group_id always resolve to the latest published version automatically.
\- is_editable: true means this row is a draft and can still be patched in place via PATCH /v3/questionnaires/{questionnaire_uuid}/.
\- question_types is an aggregated array of the form-element types present in each questionnaire (excluding section headers and separators) so you can label cards in the UI without a follow-up call.

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

What to read from the response:
\- uuid — per-version questionnaire id, used as path id in GET / PATCH / DELETE /v3/questionnaires/{questionnaire_uuid}/.
\- questionnaire_id / questionnaire_group_id — pass as config.questionnaire_uuid when attaching the questionnaire to a workflow.

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope when the API key cannot list questionnaires for this application.
\- 429 — rate limited; back off and retry.

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/ 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/: get: tags: - Questionnaires summary: Lister les questionnaires description: >- Lister vos questionnaires, les plus récents en premier, dans une enveloppe de pagination limit/offset (`{count, next, previous, results}`, taille de page par défaut 50). Chaque ligne correspond à une version ; `questionnaire_group_id` est l'identifiant de groupe stable correspondant à la dernière version `published`. operationId: list_questionnaires parameters: - name: limit in: query required: false schema: type: integer default: 50 description: Taille de page (nombre de questionnaires par page). - name: offset in: query required: false schema: type: integer default: 0 description: Nombre de lignes à ignorer avant le premier questionnaire retourné. responses: '200': description: >- Une page de questionnaires triés par `created_at` décroissant, encapsulée dans l'enveloppe de pagination. Chaque élément de `results` est un `QuestionnaireListItem`. content: application/json: schema: type: object properties: count: type: integer description: >- Nombre total de versions de questionnaire pour l'application. next: type: string format: uri nullable: true description: URL de la page suivante, ou `null` sur la dernière page. previous: type: string format: uri nullable: true description: URL de la page précédente, ou `null` sur la première page. results: type: array items: $ref: '#/components/schemas/QuestionnaireListItem' examples: One questionnaire: summary: Un simple questionnaire bilingue value: count: 1 next: null previous: null results: - uuid: 11111111-2222-3333-4444-555555555555 title: KYC Questionnaire description: Additional verification questions languages: - en - es default_language: en is_active: true is_simple_questionnaire: true created_at: '2026-04-23T09:55:00Z' updated_at: '2026-04-23T10:00:00Z' question_types: - SHORT_TEXT - MULTIPLE_CHOICE - FILE_UPLOAD workflow_names: [] 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. '429': description: >- Limite de débit dépassée. Réessayez avec une temporisation exponentielle. '500': description: >- Erreur serveur inattendue lors de la construction de la liste. 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/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.questionnaires.list(): print(item) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.questionnaires.list()) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Questionnaires.ListAutoPaging(ctx, didit.QuestionnairesListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.questionnaires().list()) { System.out.println(item); } - lang: php label: PHP source: |- questionnaires->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.questionnaires.list.auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Questionnaires.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: QuestionnaireListItem: type: object description: Une version de questionnaire dans la vue en liste. properties: uuid: type: string format: uuid description: >- UUID par version. À utiliser comme `{questionnaire_uuid}` pour la consultation, la mise à jour et la suppression, ainsi que comme `questionnaire_uuid` dans la configuration de fonctionnalité QUESTIONNAIRE d'un workflow. 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 description: >- Vrai pour les questionnaires linéaires créés via cette API ; faux pour les questionnaires basés sur un graphe créés dans la Console. created_at: type: string format: date-time updated_at: type: string format: date-time question_types: type: array items: type: string description: >- Types d'éléments en majuscules des questions auxquelles il est possible de répondre, dans l'ordre de création (par exemple `SHORT_TEXT`, `MULTIPLE_CHOICE`, `FILE_UPLOAD`). Les éléments structurels `SECTION_HEADER` et `SEPARATOR` sont exclus. Une entrée par question, les valeurs peuvent donc se répéter. workflow_names: type: array items: type: string description: >- Noms des workflows utilisant ce questionnaire. Actuellement toujours `[]` sur cet endpoint (renseigné uniquement dans la liste de la Console). questionnaire_group_id: type: string format: uuid description: >- Identifiant stable qui regroupe toutes les versions du même questionnaire. version: type: integer description: Numéro de version au sein du groupe, commençant à 1. status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true description: >- Date et heure auxquelles cette version a été publiée. `null` pour les brouillons. is_editable: type: boolean description: Vrai lorsque cette version est un `draft`. 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.