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

# Envoyer un questionnaire de due diligence VASP via l'API

> Envoyez le questionnaire de due diligence standard de Didit à une adresse de conformité enregistrée pour une contrepartie VASP Travel Rule.



Prompt de l'API pour envoyer un questionnaire VASP
        Copier le prompt dans le presse-papiers



      
      

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



      
      

Coller dans



## OpenAPI

````yaml fr/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 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/travel-rule/vasps/{vasp_id}/questionnaires/:
    post:
      tags:
        - Travel Rule
      summary: Envoyer un questionnaire de diligence raisonnable à un VASP
      description: >-
        Envoyer par e-mail le questionnaire de diligence raisonnable standard de
        Didit à une adresse de conformité enregistrée pour la contrepartie, avec
        un lien de réponse à usage unique. La contrepartie dispose de 30 jours
        pour répondre à chaque question ; les réponses restent valables 365
        jours. Un nouvel envoi remplace votre précédent questionnaire resté sans
        réponse pour la même contrepartie, dont le lien cesse de fonctionner. Un
        e-mail par minute et par adresse.
      operationId: sendTravelRuleVaspQuestionnaire
      parameters:
        - name: vasp_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            L'identifiant d'une ligne de GET /v3/travel-rule/vasps/ : une entrée
            de l'annuaire ou un membre du réseau Didit.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TravelRuleCounterpartyQuestionnaireRequest'
            example:
              sent_to: travelrule@counterparty.example
      responses:
        '202':
          description: Le questionnaire a été envoyé par e-mail.
          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 n'est pas une adresse e-mail valide ou n'est pas une adresse
            de conformité enregistrée pour la contrepartie, ou la contrepartie
            n'a aucune adresse de conformité enregistrée.
          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: >-
            Aucune entrée d'annuaire ou aucun membre répertorié du réseau Didit
            ne possède cet identifiant. Votre propre profil VASP n'est jamais
            une contrepartie pour vous.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: No directory entry or Didit network member has this id.
        '429':
          description: >-
            Un questionnaire a été envoyé à cette adresse il y a moins d'une
            minute.
        '503':
          description: >-
            L'e-mail n'a pas pu être envoyé et aucun questionnaire n'a été créé.
            Réessayez dans un instant.
      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: "Optionnel. Une adresse de conformité enregistrée pour la contrepartie\_: pour une entrée d'annuaire, son adresse de conformité ou un contact visible par votre application\_; pour un membre du réseau Didit, son e-mail de conformité confirmé. Par défaut\_: l'adresse à laquelle un e-mail Travel Rule destiné à la contrepartie est envoyé (votre propre contact en premier, puis un contact de la plateforme, puis l'adresse de conformité de l'entrée)."
    TravelRuleCounterpartyQuestionnaire:
      type: object
      description: >-
        Un questionnaire de vigilance envoyé par votre application à la
        contrepartie : le questionnaire standard de Didit, envoyé par e-mail à
        une adresse de conformité enregistrée avec un lien de réponse à usage
        unique. Réservé à votre application.
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - SENT
            - ANSWERED
            - EXPIRED
          description: >-
            SENT : en attente de réponses. ANSWERED : la contrepartie a répondu
            à toutes les questions. EXPIRED : le lien de réponse s'est fermé
            sans réponse (son délai a expiré ou un questionnaire plus récent l'a
            remplacé), ou les réponses ont dépassé valid_until.
        form_version:
          type: string
          description: >-
            Version du questionnaire standard de Didit à laquelle les réponses
            appartiennent. Actuellement 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: >-
            La date limite de réponse, 30 jours après l'envoi. Le lien cesse de
            fonctionner après cette échéance.
        answered_at:
          type: string
          format: date-time
          nullable: true
        valid_until:
          type: string
          format: date-time
          nullable: true
          description: >-
            Durée pendant laquelle les réponses restent valides : 365 jours
            après avoir répondu. Null tant qu'aucune réponse n'a été apportée.
        current:
          type: boolean
          description: >-
            true tant que le questionnaire est ANSWERED et que valid_until n'est
            pas dépassé.
        answers:
          type: object
          additionalProperties:
            type: string
          description: >-
            Les réponses indexées par l'ID de question : legal_name, licensing,
            jurisdictions, aml_program, compliance_officer, sanctions_screening,
            transaction_monitoring, travel_rule, custody, ownership,
            record_keeping, data_protection. Chaque réponse contient jusqu'à 2
            000 caractères. Les réponses sont vides jusqu'à ce qu'une réponse
            soit apportée.
  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.