> ## 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.

# VASP-Due-Diligence-Fragebogen senden – API

> Didit sendet den Standard-Due-Diligence-Fragebogen per E-Mail an eine hinterlegte Compliance-Adresse eines Travel-Rule-Gegenpart-VASP.



Prompt für die API zum Senden eines VASP-Fragebogens
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\`Email Didit's standard due-diligence questionnaire to a Travel Rule counterparty VASP.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/questionnaires/

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

Example call:
curl -X POST "https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/questionnaires/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"sent_to": "travelrule@counterparty.example"}'

Body (optional):
\- sent_to - a compliance address on record for the counterparty: for a directory entry its compliance address or a contact my application sees (GET /v3/travel-rule/vasps/{vasp_id}/ lists contacts), for a Didit network member its confirmed compliance email. Default: the address a Travel Rule email to the counterparty goes to (my own contact first, then a platform contact, then the entry's compliance address). Any other address is refused.

What happens:
\- 202 with the questionnaire {id, status: "SENT", form_version, sent_to, sent_at, expires_at, ...}. The email carries a single-use link to a page where the counterparty answers every question of Didit's standard questionnaire.
\- The counterparty has 30 days (expires_at); after that the link stops working and the questionnaire is EXPIRED.
\- Once answered, the status is ANSWERED and the answers stay current for 365 days (valid_until). Read them with GET /v3/travel-rule/vasps/{vasp_id}/questionnaires/.
\- A new send replaces my earlier unanswered questionnaire to the same counterparty: that one becomes EXPIRED and its link stops working.
\- The questionnaire and its answers are private to my application.

Failure modes:
\- 400 - sent_to is not a valid email or not a compliance address on record, or the counterparty has no compliance address on record yet.
\- 404 - no directory entry or listed Didit network member has this id, or the id is my own VASP profile.
\- 429 - a questionnaire went to this address less than a minute ago.
\- 503 - the email could not be sent and no questionnaire was created; try again.

Full guide: /transaction-monitoring/travel-rule#due-diligence-questionnaire.`

\</pre>



      
      

Einfügen in



## OpenAPI

````yaml de/openapi-25.json POST /v3/travel-rule/vasps/{vasp_id}/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/travel-rule/vasps/{vasp_id}/questionnaires/:
    post:
      tags:
        - Travel Rule
      summary: Due-Diligence-Fragebogen an einen VASP senden
      description: >-
        Didits Standard-Due-Diligence-Fragebogen per E-Mail an eine hinterlegte
        Compliance-Adresse der Gegenpartei mit einem Antwortlink zur einmaligen
        Verwendung senden. Die Gegenpartei hat 30 Tage Zeit, jede Frage zu
        beantworten; die Antworten bleiben 365 Tage lang gültig. Ein erneutes
        Senden ersetzt Ihren früheren unbeantworteten Fragebogen an dieselbe
        Gegenpartei, dessen Link ungültig wird. Eine E-Mail pro Minute pro
        Adresse.
      operationId: sendTravelRuleVaspQuestionnaire
      parameters:
        - name: vasp_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Die ID einer Zeile aus der Antwort von GET /v3/travel-rule/vasps/:
            ein Verzeichniseintrag oder ein Mitglied des Didit-Netzwerks.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TravelRuleCounterpartyQuestionnaireRequest'
            example:
              sent_to: travelrule@counterparty.example
      responses:
        '202':
          description: Der Fragebogen wurde per E-Mail versendet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleCounterpartyQuestionnaire'
              example:
                id: 3f9e8d7c-6b5a-4c3d-9e2f-1a0b9c8d7e6f
                status: SENT
                form_version: '1'
                sent_to: travelrule@counterparty.example
                sent_at: '2026-10-14T10:00:00Z'
                expires_at: '2026-11-13T10:00:00Z'
                answered_at: null
                valid_until: null
                current: false
                answers: {}
        '400':
          description: >-
            sent_to ist keine gültige E-Mail-Adresse oder keine hinterlegte
            Compliance-Adresse der Gegenpartei, oder für die Gegenpartei ist
            keine Compliance-Adresse hinterlegt.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
              examples:
                Not on record:
                  value:
                    sent_to:
                      - >-
                        Send the questionnaire to a compliance address on record
                        for this counterparty.
                No address:
                  value:
                    sent_to:
                      - >-
                        No compliance address is on record for this
                        counterparty. Add a contact for it first.
        '404':
          description: >-
            Kein Verzeichniseintrag und kein gelistetes Didit-Netzwerkmitglied
            besitzt diese ID. Ihr eigenes VASP-Profil ist niemals eine
            Gegenpartei von Ihnen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: No directory entry or Didit network member has this id.
        '429':
          description: >-
            Ein Fragebogen wurde vor weniger als einer Minute an diese Adresse
            gesendet.
        '503':
          description: >-
            Die E-Mail konnte nicht gesendet werden und es wurde kein Fragebogen
            erstellt. Versuchen Sie es gleich noch einmal.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/questionnaires/
            \
              -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
              -d '{"sent_to": "travelrule@counterparty.example"}'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.travel_rule.send_vasp_questionnaire(
                "11111111-2222-3333-4444-555555555555",
                sent_to="travelrule@counterparty.example",
            )
            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.travelRule.sendVaspQuestionnaire("11111111-2222-3333-4444-555555555555",
            {
              sent_to: "travelrule@counterparty.example",
            });

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.TravelRule.SendVASPQuestionnaire(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleCounterpartyQuestionnaireRequest{\n\tSentTo: didit.String(\"travelrule@counterparty.example\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;

            import me.didit.types.TravelRuleCounterpartyQuestionnaireRequest;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.travelRule().sendVaspQuestionnaire("11111111-2222-3333-4444-555555555555",
            TravelRuleCounterpartyQuestionnaireRequest.builder()
                    .sentTo("travelrule@counterparty.example")
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->travelRule->sendVaspQuestionnaire('11111111-2222-3333-4444-555555555555',
            [
                'sent_to' => 'travelrule@counterparty.example',
            ]);

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.travel_rule.send_vasp_questionnaire(
              "11111111-2222-3333-4444-555555555555",
              sent_to: "travelrule@counterparty.example"
            )
            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.TravelRule.SendVaspQuestionnaireAsync("11111111-2222-3333-4444-555555555555",
            new TravelRuleCounterpartyQuestionnaireRequest

            {
                SentTo = "travelrule@counterparty.example",
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    TravelRuleCounterpartyQuestionnaireRequest:
      type: object
      properties:
        sent_to:
          type: string
          format: email
          description: >-
            Optional. Eine für die Gegenpartei hinterlegte Compliance-Adresse:
            für einen Verzeichniseintrag dessen Compliance-Adresse oder ein
            Kontakt, den Ihre Anwendung sieht, für ein Mitglied des
            Didit-Netzwerks dessen bestätigte Compliance-E-Mail. Standard: die
            Adresse, an die eine Travel-Rule-E-Mail an die Gegenpartei gesendet
            wird (zuerst Ihr eigener Kontakt, dann ein Plattformkontakt, danach
            die Compliance-Adresse des Eintrags).
    TravelRuleCounterpartyQuestionnaire:
      type: object
      description: >-
        Ein Due-Diligence-Fragebogen, den Ihre Anwendung an die Gegenpartei
        gesendet hat: Didits Standard-Fragebogen, per E-Mail an eine hinterlegte
        Compliance-Adresse mit einem einmaligen Link zur Beantwortung gesendet.
        Nur für Ihre Anwendung sichtbar.
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - SENT
            - ANSWERED
            - EXPIRED
          description: >-
            SENT: Warten auf Antworten. ANSWERED: Die Gegenpartei hat jede Frage
            beantwortet. EXPIRED: Der Antwortlink wurde unbeantwortet
            geschlossen (die Frist ist abgelaufen oder ein neuerer Fragebogen
            hat ihn ersetzt), oder die Antworten haben valid_until
            überschritten.
        form_version:
          type: string
          description: >-
            Version des Standardfragebogens von Didit, zu dem die Antworten
            gehören. Derzeit 1.
        sent_to:
          type: string
          format: email
        sent_at:
          type: string
          format: date-time
          nullable: true
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Die Frist für die Beantwortung, 30 Tage nach dem Versenden. Danach
            funktioniert der Link nicht mehr.
        answered_at:
          type: string
          format: date-time
          nullable: true
        valid_until:
          type: string
          format: date-time
          nullable: true
          description: >-
            Wie lange die Antworten aktuell bleiben: 365 Tage nach Beantwortung.
            Null bis zur Beantwortung.
        current:
          type: boolean
          description: >-
            true, solange der Fragebogen ANSWERED ist und valid_until noch nicht
            überschritten wurde.
        answers:
          type: object
          additionalProperties:
            type: string
          description: >-
            Die Antworten, geschlüsselt nach Fragen-ID: legal_name, licensing,
            jurisdictions, aml_program, compliance_officer, sanctions_screening,
            transaction_monitoring, travel_rule, custody, ownership,
            record_keeping, data_protection. Jede Antwort umfasst bis zu 2.000
            Zeichen. Leer, bis sie beantwortet wurden.
  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.