> ## 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. # Fragebogen erstellen API: Individuelles KYC-Formular > Erstellen Sie individuelle KYC- und Compliance-Fragebögen per API mit geordneten Fragen, Optionen und 54 Sprachübersetzungen. Abrechnung pro Aufruf bei Didit. Prompt für die API-Erstellung eines Fragebogens Prompt in die Zwischenablage kopieren \

\`Create a simple Didit questionnaire through the Management API.

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

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

Requirements:
\- Use the simple v3 API shape with form_elements.
\- Do not send graph, branches, next, required_if, or conditional logic.
\- Include languages with en and default_language set to en.
\- Use customer-friendly element_type values such as short_text, multiple_choice, email, file_upload, or date_picker.
\- For choice questions, send options with value and label.
\- Store the questionnaire_id from the response because I will use it later as questionnaire_uuid in workflows.

Example request body:
\{
"title": "Customer Onboarding",
"languages": ["en"],
"default_language": "en",
"form_elements": [
\{
  "id": "occupation",
  "element_type": "short_text",
  "label": { "en": "What is your occupation?" },
  "is_required": true
},
\{
  "id": "source_of_funds",
  "element_type": "multiple_choice",
  "label": { "en": "Source of funds" },
  "is_required": true,
  "options": [
    \{ "value": "employment", "label": { "en": "Employment" } },
    \{ "value": "business", "label": { "en": "Business" } },
    \{ "value": "investments", "label": { "en": "Investments" } }
  ]
}
]
}

Build the API call, handle validation errors, and return the questionnaire_id from the response.`

\
Einfügen in Verwenden Sie diesen Endpoint, um einfache Fragebögen über die API zu erstellen. Senden Sie ein `form_elements`-Array in der Reihenfolge, in der die Benutzer die Fragen beantworten sollen. Didit erstellt den internen Fragebogen-Graphen für Sie.Die API unterstützt nur einfache lineare Fragebögen. Senden Sie kein `graph`, keine `branches`, kein `next` und keine bedingten Regeln.## Pflichtfelder- `title` ist der interne Name des Fragebogens. - `languages` muss `en` enthalten. - `form_elements` muss mindestens eine Frage enthalten. - Jedes Formularelement benötigt einen `element_type` und ein übersetztes `label`.Sie können einem Formularelement außerdem optional eine übersetzte `description` als Hilfetext hinzufügen. Sie wird bei allen Elementtypen außer `separator` akzeptiert und im [Fragebogenbericht](https://docs.didit.me/de/core-technology/questionnaires/report-questionnaire.md) als `description` des Elements zurückgegeben.## ElementtypenVerwenden Sie Werte in Kleinbuchstaben wie `short_text`, `multiple_choice`, `email`, `file_upload` oder `date_picker`. Großgeschriebene Enum-Werte wie `SHORT_TEXT` werden ebenfalls akzeptiert.Für `dropdown`, `single_choice` und `multiple_choice` fügen Sie `options` hinzu. Wenn Sie den `value` einer Option weglassen, erzeugt Didit einen Wert aus dem Label.```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": { "en": "What is your occupation?" }, "is_required": true }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": { "en": "Source of funds" }, "is_required": true, "options": [ { "value": "employment", "label": { "en": "Employment" } }, { "value": "business", "label": { "en": "Business" } }, { "value": "investments", "label": { "en": "Investments" } } ] } ] } ```## FeldvalidierungFügen Sie einem `short_text`-, `long_text`- oder `number`-Element ein optionales `validation`-Objekt hinzu, um ein Format für die Antwort des Benutzers zu erzwingen. Das ist nützlich für Kennungen mit strengen Formaten wie Steuernummern, nationalen Kennungen oder Kartennummern. Die Validierung läuft, während der Benutzer das Feld ausfüllt (der Benutzer kann erst fortfahren, wenn die Antwort die Validierung besteht), und wird bei der Übermittlung von der API erneut erzwungen.| Feld | Gilt für | Beschreibung | | - | - | - | | `pattern` | `short_text`, `long_text` | Regulärer Ausdruck, dem der Wert vollständig entsprechen muss. Verwenden Sie die portable Teilmenge von ECMA-262; fügen Sie keine `^`/`$`-Anker hinzu (der gesamte Wert wird abgeglichen). | | `min_length` | `short_text`, `long_text` | Mindestanzahl an Zeichen. | | `max_length` | `short_text`, `long_text` | Höchstanzahl an Zeichen. | | `min` | `number` | Minimaler numerischer Wert. | | `max` | `number` | Maximaler numerischer Wert. | | `error_message` | alle oben genannten | Übersetzte Meldung, die angezeigt wird, wenn der Wert die Validierung nicht besteht. Wird sie weggelassen, wird eine allgemeine Meldung verwendet. |```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "tax_id", "element_type": "short_text", "label": { "en": "Tax ID" }, "is_required": true, "validation": { "pattern": "[A-Z]{2}[0-9]{9}", "min_length": 11, "max_length": 11, "error_message": { "en": "Enter a valid Tax ID (2 letters followed by 9 digits)." } } } ] } ```Die Antwort enthält `questionnaire_id`. Speichern Sie diese ID, denn Sie verwenden sie als `questionnaire_uuid`, wenn Sie den Fragebogen einem Workflow hinzufügen. ## OpenAPI ````yaml de/openapi-25.json POST /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/: post: tags: - Questionnaires summary: Fragebogen erstellen description: >- Erstellen Sie einen einfachen linearen Fragebogen. Senden Sie `form_elements` in der Anzeigereihenfolge; Verzweigungen und wiederholbare Gruppen erfordern die Console. Standardwert ist `published` v1. operationId: create_questionnaire requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SimpleQuestionnaireRequest' examples: Simple: summary: Einfacher Fragebogen value: title: Customer Onboarding description: Additional information needed for verification default_language: en languages: - en is_active: true form_elements: - id: occupation element_type: short_text label: en: What is your occupation? is_required: true placeholder: en: Software engineer - id: source_of_funds element_type: multiple_choice label: en: Source of funds is_required: true options: - value: employment label: en: Employment - value: business label: en: Business - value: investments label: en: Investments - value: other label: en: Other responses: '201': description: >- Fragebogen erstellt. Die Antwort enthält die `questionnaire_id` — speichern Sie diese, um aus Workflows oder bei künftigen Update-/Löschaufrufen auf diesen Fragebogen zu verweisen. content: application/json: schema: $ref: '#/components/schemas/QuestionnaireDetail' examples: Created: 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: [] questionnaire_group_id: 11111111-2222-3333-4444-555555555555 version: 1 status: published published_at: '2026-04-23T10:00:00Z' is_editable: false '400': description: >- Validierungsfehler. Häufige Ursachen: ein unbekannter `element_type`, ein übersetzbares Feld ohne Übersetzung für eine der `languages`, `languages` enthält kein `en`, `default_language` nicht in `languages`, eine Option ohne `label`, eine Frage mit `branches`/`required_if`/`repeatable_config` (von diesem Endpoint nicht unterstützt) oder das Senden eines unverarbeiteten `graph` anstelle von `form_elements`. Der Body ist ein DRF-Validierungsfehler mit Feldnamen als Schlüsseln. content: application/json: examples: Graph not accepted: value: graph: >- The v3 questionnaire API only accepts simple `form_elements`, not `graph`. Missing label: value: form_elements: - label: - This field is required. '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. '415': description: >- Nicht unterstützter Medientyp. Setzen Sie `Content-Type: application/json` und senden Sie einen JSON-Body. '429': description: >- Rate-Limit überschritten. Wiederholen Sie die Anfrage mit exponentiellem Backoff. '500': description: >- Unerwarteter Serverfehler beim Erstellen des Fragebogens. Kann sicher wiederholt werden. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl -X POST 'https://verification.didit.me/v3/questionnaires/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "title": "Customer Onboarding", "default_language": "en", "languages": ["en"], "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "is_required": true } ] }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.questionnaires.create( title="Customer Onboarding", description="Additional information needed for verification", languages=["en"], default_language="en", is_active=True, form_elements=[{ "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "placeholder": {"en": "Software engineer"}, "is_required": True, }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": {"en": "Source of funds"}, "is_required": True, "options": [{ "value": "employment", "label": {"en": "Employment"}, }, { "value": "business", "label": {"en": "Business"}, }, { "value": "investments", "label": {"en": "Investments"}, }, { "value": "other", "label": {"en": "Other"}, }], }], ) 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.create({ title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Questionnaires.Create(ctx, didit.SimpleQuestionnaireRequest{\n\tTitle: \"Customer Onboarding\",\n\tDescription: didit.String(\"Additional information needed for verification\"),\n\tLanguages: []string{\"en\"},\n\tDefaultLanguage: didit.String(\"en\"),\n\tIsActive: didit.Bool(true),\n\tFormElements: []didit.SimpleQuestionnaireElement{{\n\t\tID: didit.String(\"occupation\"),\n\t\tElementType: \"short_text\",\n\t\tLabel: map[string]string{\"en\": \"What is your occupation?\"},\n\t\tPlaceholder: didit.Some(map[string]string{\"en\": \"Software engineer\"}),\n\t\tIsRequired: didit.Bool(true),\n\t}, {\n\t\tID: didit.String(\"source_of_funds\"),\n\t\tElementType: \"multiple_choice\",\n\t\tLabel: map[string]string{\"en\": \"Source of funds\"},\n\t\tIsRequired: didit.Bool(true),\n\t\tOptions: didit.Some([]didit.SimpleQuestionnaireElementOptions{{\n\t\t\tValue: didit.String(\"employment\"),\n\t\t\tLabel: map[string]string{\"en\": \"Employment\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"business\"),\n\t\t\tLabel: map[string]string{\"en\": \"Business\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"investments\"),\n\t\t\tLabel: map[string]string{\"en\": \"Investments\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"other\"),\n\t\t\tLabel: map[string]string{\"en\": \"Other\"},\n\t\t}}),\n\t}},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import java.util.Map; import me.didit.Didit; import me.didit.types.SimpleQuestionnaireElement; import me.didit.types.SimpleQuestionnaireRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.questionnaires().create(SimpleQuestionnaireRequest.builder() .title("Customer Onboarding") .description("Additional information needed for verification") .languages(List.of("en")) .defaultLanguage("en") .isActive(true) .formElements(List.of( SimpleQuestionnaireElement.builder() .id("occupation") .elementType(SimpleQuestionnaireElement.ElementType.of("short_text")) .label(Map.of("en", "What is your occupation?")) .placeholder(Map.of("en", "Software engineer")) .isRequired(true) .build(), SimpleQuestionnaireElement.builder() .id("source_of_funds") .elementType(SimpleQuestionnaireElement.ElementType.of("multiple_choice")) .label(Map.of("en", "Source of funds")) .isRequired(true) .options(List.of( SimpleQuestionnaireElement.Options.builder() .value("employment") .label(Map.of("en", "Employment")) .build(), SimpleQuestionnaireElement.Options.builder() .value("business") .label(Map.of("en", "Business")) .build(), SimpleQuestionnaireElement.Options.builder() .value("investments") .label(Map.of("en", "Investments")) .build(), SimpleQuestionnaireElement.Options.builder() .value("other") .label(Map.of("en", "Other")) .build())) .build())) .build()); System.out.println(result); - lang: php label: PHP source: |- questionnaires->create([ 'title' => 'Customer Onboarding', 'description' => 'Additional information needed for verification', 'languages' => ['en'], 'default_language' => 'en', 'is_active' => true, 'form_elements' => [[ 'id' => 'occupation', 'element_type' => 'short_text', 'label' => ['en' => 'What is your occupation?'], 'placeholder' => ['en' => 'Software engineer'], 'is_required' => true, ], [ 'id' => 'source_of_funds', 'element_type' => 'multiple_choice', 'label' => ['en' => 'Source of funds'], 'is_required' => true, 'options' => [[ 'value' => 'employment', 'label' => ['en' => 'Employment'], ], [ 'value' => 'business', 'label' => ['en' => 'Business'], ], [ 'value' => 'investments', 'label' => ['en' => 'Investments'], ], [ 'value' => 'other', 'label' => ['en' => 'Other'], ]], ]], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.questionnaires.create( title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }] ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Questionnaires.CreateAsync(new SimpleQuestionnaireRequest { Title = "Customer Onboarding", Description = "Additional information needed for verification", Languages = new string[] { "en" }, DefaultLanguage = "en", IsActive = true, FormElements = new SimpleQuestionnaireElement[] { new() { Id = "occupation", ElementType = "short_text", Label = new Dictionary { ["en"] = "What is your occupation?" }, Placeholder = new Dictionary { ["en"] = "Software engineer" }, IsRequired = true, }, new() { Id = "source_of_funds", ElementType = "multiple_choice", Label = new Dictionary { ["en"] = "Source of funds" }, IsRequired = true, Options = new SimpleQuestionnaireElementOptions[] { new() { Value = "employment", Label = new Dictionary { ["en"] = "Employment" }, }, new() { Value = "business", Label = new Dictionary { ["en"] = "Business" }, }, new() { Value = "investments", Label = new Dictionary { ["en"] = "Investments" }, }, new() { Value = "other", Label = new Dictionary { ["en"] = "Other" }, }, }, }, }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SimpleQuestionnaireRequest: type: object description: >- Erstellen Sie einen einfachen linearen Fragebogen. Die API wandelt `form_elements` intern in den Fragebogen-Graphen um. required: - title - languages - form_elements properties: title: type: string description: Interner Name für den Fragebogen. description: type: string nullable: true languages: type: array description: In jeder Bezeichnung enthaltene Sprachen. Muss `en` enthalten. items: type: string example: - en default_language: type: string description: Standardsprache. Muss in `languages` enthalten sein. example: en is_active: type: boolean default: true status: type: string enum: - draft - published description: >- Lassen Sie dieses Feld weg, um einen veröffentlichten Fragebogen zu erstellen, der für Workflows bereit ist. form_elements: type: array minItems: 1 description: >- Fragen in der genauen Reihenfolge, in der Benutzer sie sehen sollen. Verzweigungen und bedingte Felder werden nicht unterstützt. items: $ref: '#/components/schemas/SimpleQuestionnaireElement' QuestionnaireDetail: type: object description: >- Vollständige Fragebogendetails, die von den Endpoints GET, POST (Erstellen) und PATCH (Aktualisieren) zurückgegeben werden. properties: questionnaire_id: type: string format: uuid description: >- Eindeutige Kennung des Fragebogens. Verwenden Sie diese ID, wenn Sie aus einem Workflow oder in nachfolgenden Update-/Löschanfragen auf den Fragebogen verweisen. 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: Graphstruktur mit start_node und nodes-Map. sections: type: array description: >- In Abschnitte gruppierter Fragebogeninhalt (aus dem Graph abgeleitet). items: type: object questionnaire_group_id: type: string format: uuid description: Stabile Kennung, die alle Versionen desselben Fragebogens gruppiert. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: >- True, wenn der Fragebogen noch direkt bearbeitet werden kann (Entwurfsversionen). SimpleQuestionnaireElement: type: object required: - element_type - label properties: id: type: string description: >- Optionale stabile Fragen-ID. Wenn sie weggelassen wird, generiert die API `q1`, `q2` usw. Verwenden Sie zur besseren Lesbarkeit Kleinbuchstaben, Zahlen und Unterstriche. example: source_of_funds element_type: type: string description: >- Fragetyp. Die API akzeptiert diese Werte in Kleinbuchstaben und deren Entsprechungen in Großbuchstaben. enum: - short_text - long_text - dropdown - single_choice - multiple_choice - number - image - file_upload - time - email - address - phone - country - date_picker - consent - section_header - separator - heading - paragraph label: type: object description: >- Fragebezeichnung nach Sprachcode, zum Beispiel `{ "en": "Source of funds" }`. additionalProperties: type: string description: type: object nullable: true additionalProperties: type: string placeholder: type: object nullable: true additionalProperties: type: string is_required: type: boolean default: false options: type: array description: >- Für `dropdown`, `single_choice` und `multiple_choice` verwenden. Wenn `value` weggelassen wird, generiert die API einen Wert aus der Optionsbezeichnung. items: type: object required: - label properties: value: type: string label: type: object additionalProperties: type: string max_files: type: integer minimum: 1 maximum: 5 description: Mit `file_upload` oder `image` verwenden. validation: type: object nullable: true description: >- Optionale Formatvalidierung für `short_text`, `long_text` oder `number`. Wird erzwungen, während der Benutzer das Feld ausfüllt (er kann nicht fortfahren, bis die Validierung erfolgreich ist), und bei der Übermittlung von der API erneut geprüft. properties: pattern: type: string description: >- Regulärer Ausdruck (ECMA-262-Teilmenge), mit dem der Wert vollständig übereinstimmen muss. Für `short_text` und `long_text`. Keine ^/$-Anker hinzufügen; der gesamte Wert wird abgeglichen. min_length: type: integer minimum: 0 description: Mindestanzahl von Zeichen. Für `short_text` und `long_text`. max_length: type: integer minimum: 0 description: Maximale Zeichenanzahl. Für `short_text` und `long_text`. min: type: number description: Numerischer Mindestwert. Für `number`. max: type: number description: Maximaler numerischer Wert. Für `number`. error_message: type: object description: >- Übersetzte Nachricht, die bei fehlgeschlagener Validierung angezeigt wird, nach Sprachcode geschlüsselt. additionalProperties: type: string 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.