> ## 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. # Fragebögen auflisten: Management-API für KYC-Formulare > Rufen Sie alle KYC-Fragebögen und Compliance-Formulare Ihrer Didit-Organisation mit einem Aufruf ab. Verwaltung individueller KYC-Formulare per API, pro Aufruf. Prompt für die API zum Auflisten von Fragebögen Prompt in die Zwischenablage kopieren \

\`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.`

\
Einfügen in ## OpenAPI ````yaml de/openapi-25.json GET /v3/questionnaires/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/: get: tags: - Questionnaires summary: Fragebögen auflisten description: >- Listet Ihre Fragebögen auf, die neuesten zuerst, in einem Paginierungs-Umschlag mit Limit/Offset (`{count, next, previous, results}`, Standard-Seitengröße 50). Jede Zeile stellt eine Version dar; `questionnaire_group_id` ist die stabile Gruppen-ID, die auf die neueste `published`-Version verweist. operationId: list_questionnaires parameters: - name: limit in: query required: false schema: type: integer default: 50 description: Seitengröße (Anzahl der Fragebögen pro Seite). - name: offset in: query required: false schema: type: integer default: 0 description: >- Anzahl der vor dem ersten zurückgegebenen Fragebogen zu überspringenden Zeilen. responses: '200': description: >- Eine Seite mit Fragebögen, absteigend nach `created_at` sortiert, eingebettet in das Paginierungsobjekt. Jedes Element in `results` ist ein `QuestionnaireListItem`. content: application/json: schema: type: object properties: count: type: integer description: Gesamtzahl der Fragebogenversionen für die Anwendung. next: type: string format: uri nullable: true description: URL der nächsten Seite oder `null` auf der letzten Seite. previous: type: string format: uri nullable: true description: URL der vorherigen Seite oder `null` auf der ersten Seite. results: type: array items: $ref: '#/components/schemas/QuestionnaireListItem' examples: One questionnaire: summary: Ein einfacher zweisprachiger Fragebogen 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: >- API-Schlüssel fehlt, ist fehlerhaft, abgelaufen oder für eine andere Anwendung gültig. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '429': description: >- Rate-Limit überschritten. Wiederholen Sie die Anfrage mit exponentiellem Backoff. '500': description: >- Unerwarteter Serverfehler beim Erstellen der Liste. Kann sicher wiederholt werden. 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: Eine Fragebogenversion in der Listenansicht. properties: uuid: type: string format: uuid description: >- Versionsspezifische UUID. Verwenden Sie sie als `{questionnaire_uuid}` zum Abrufen, Aktualisieren und Löschen sowie als `questionnaire_uuid` in der QUESTIONNAIRE-Funktionskonfiguration eines Workflows. 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: >- True für lineare Fragebögen, die über diese API erstellt wurden; false für graphbasierte Fragebögen, die in der Konsole erstellt wurden. created_at: type: string format: date-time updated_at: type: string format: date-time question_types: type: array items: type: string description: >- Elementtypen der beantwortbaren Fragen in Großbuchstaben in der Reihenfolge ihrer Erstellung (z. B. `SHORT_TEXT`, `MULTIPLE_CHOICE`, `FILE_UPLOAD`). Strukturelle `SECTION_HEADER`- und `SEPARATOR`-Elemente sind ausgeschlossen. Ein Eintrag pro Frage, Werte können sich also wiederholen. workflow_names: type: array items: type: string description: >- Namen von Workflows, die diesen Fragebogen verwenden. Derzeit an diesem Endpoint immer `[]` (wird nur in der Konsolenauflistung ausgefüllt). questionnaire_group_id: type: string format: uuid description: Stabile Kennung, die alle Versionen desselben Fragebogens gruppiert. version: type: integer description: Versionsnummer innerhalb der Gruppe, beginnend bei 1. status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true description: Wann diese Version veröffentlicht wurde. `null` für Entwürfe. is_editable: type: boolean description: Wahr, wenn diese Version ein `draft` ist. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.