> ## 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. # Travel-Rule-Nachricht senden: API-Referenz > Mit Didit eine Nachricht oder Dokumentenanfrage an die Gegen-VASP einer Travel-Rule-Überweisung senden, optional mit Anhängen. Travel Rule-Nachricht senden: API-Prompt Prompt in die Zwischenablage kopieren \

\`Send a message or a document request to the counterparty VASP of a Travel Rule transfer, so a disputed transfer is resolved inside Didit.

Endpoint:
POST https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/

Authentication:
Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid on my application.

Request body (JSON, or multipart/form-data when attaching files):
\- kind - MESSAGE (default) or DOCUMENT_REQUEST.
\- body - up to 5000 characters. A MESSAGE needs a body or a file.
\- requested_documents - up to 10 names. A DOCUMENT_REQUEST needs at least one; a MESSAGE must not have any.
\- reply_to - uuid of an earlier message of the same transfer. A reply carrying a document fulfils the request it answers.
\- files - multipart only, up to 5 files of 10 MB each.

Example call:
curl -X POST "https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"kind": "DOCUMENT_REQUEST", "body": "Please confirm the beneficiary date of birth.", "requested_documents": ["Proof of address"]}'

Behavior:
\- Works on INTERNAL transfers (the other Didit customer sees it on its side) and EMAIL transfers (the counterparty is emailed and answers in the pickup portal).
\- A transfer holds up to 100 messages.

Failure modes:
\- 400 - invalid body, file rejected, 100 messages reached, or reply_to is not a message of this transfer.
\- 404 - unknown transaction, or no Travel Rule transfer on it.
\- 409 - no message can reach the counterparty; detail gives the reason: a network rail (TRP, GTR, TRUST, VerifyVASP, Sygna) carries no messages, no counterparty yet, an INTERNAL transfer whose data did not match the wallet holder, an INTERNAL transfer whose recipient has not proved control of the wallet yet, an EMAIL transfer whose counterparty no longer has a compliance email address, or an EMAIL transfer whose pickup link expired or whose transfer is closed.

Full guide: /transaction-monitoring/travel-rule#messages-and-document-requests.`

\
Einfügen in ## OpenAPI ````yaml de/openapi-25.json POST /v3/transactions/{transaction_id}/travel-rule/messages/ 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/transactions/{transaction_id}/travel-rule/messages/: post: tags: - Travel Rule summary: Travel-Rule-Nachricht oder Dokumentenanforderung senden description: >- Sendet eine Nachricht oder eine Dokumentenanforderung an den Gegenpartei-VASP. Funktioniert bei INTERNAL-Transfers (der andere Didit-Kunde sieht sie auf seiner Seite des Paares) und EMAIL-Transfers (die Gegenpartei erhält eine E-Mail und antwortet im Abholportal). Ein Transfer über TRP, GTR, TRUST, VerifyVASP oder Sygna übermittelt keine Nachrichten, da diese Protokolle keine Nachrichten unterstützen. Limits: 100 Nachrichten pro Transfer, 5000 Zeichen pro Textkörper, 10 angeforderte Dokumente, 5 Dateien mit jeweils 10 MB. operationId: createTravelRuleMessage parameters: - name: transaction_id in: path required: true description: Stabile Transaktions-UUID von Didit, zu der der Transfer gehört. schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRuleMessageCreateRequest' example: kind: DOCUMENT_REQUEST body: Please confirm the date of birth of the beneficiary. requested_documents: - Proof of address multipart/form-data: schema: $ref: '#/components/schemas/TravelRuleMessageCreateRequest' responses: '201': description: Die gespeicherte Nachricht. content: application/json: schema: $ref: '#/components/schemas/TravelRuleMessage' '400': description: >- Ungültiger Body, ein nicht akzeptierter Dateityp oder eine nicht akzeptierte Dateigröße, mehr als 100 Nachrichten bei der Übertragung oder ein `reply_to`, das keine Nachricht dieser Übertragung ist. content: application/json: schema: type: object example: requested_documents: - Name at least one document the counterparty should send. '404': description: >- Unbekannte Transaktion oder unbekanntes Token, oder kein Travel-Rule-Transfer für die Transaktion vorhanden. '409': description: >- Keine Nachricht kann die Gegenpartei erreichen. `detail` nennt den Grund: Der Transfer läuft über eine Netzwerkroute (TRP, GTR, TRUST, VerifyVASP oder Sygna), hat noch keine Gegenpartei, die Daten eines INTERNAL-Transfers stimmten nicht mit dem Wallet-Inhaber überein, sodass nichts beim Empfänger ankam, oder der Abruflink eines EMAIL-Transfers ist abgelaufen oder der Transfer ist geschlossen. content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"kind": "DOCUMENT_REQUEST", "body": "Please confirm the date of birth of the beneficiary.", "requested_documents": ["Proof of address"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.transactions.travel_rule.create_message( "11111111-2222-3333-4444-555555555555", kind="DOCUMENT_REQUEST", body="Please confirm the date of birth of the beneficiary.", requested_documents=["Proof of address"], ) 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.transactions.travelRule.createMessage("11111111-2222-3333-4444-555555555555", { kind: "DOCUMENT_REQUEST", body: "Please confirm the date of birth of the beneficiary.", requested_documents: ["Proof of address"], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.TravelRule.CreateMessage(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleMessageCreateRequest{\n\tKind: didit.Some(didit.TravelRuleMessageCreateRequestKind(\"DOCUMENT_REQUEST\")),\n\tBody: didit.String(\"Please confirm the date of birth of the beneficiary.\"),\n\tRequestedDocuments: didit.Some([]string{\"Proof of address\"}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.TravelRuleMessageCreateRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.transactions().travelRule().createMessage("11111111-2222-3333-4444-555555555555", TravelRuleMessageCreateRequest.builder() .kind(TravelRuleMessageCreateRequest.Kind.of("DOCUMENT_REQUEST")) .body("Please confirm the date of birth of the beneficiary.") .requestedDocuments(List.of("Proof of address")) .build()); System.out.println(result); - lang: php label: PHP source: >- transactions->travelRule->createMessage('11111111-2222-3333-4444-555555555555', [ 'kind' => 'DOCUMENT_REQUEST', 'body' => 'Please confirm the date of birth of the beneficiary.', 'requested_documents' => ['Proof of address'], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.transactions.travel_rule.create_message( "11111111-2222-3333-4444-555555555555", kind: "DOCUMENT_REQUEST", body: "Please confirm the date of birth of the beneficiary.", requested_documents: ["Proof of address"] ) 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.Transactions.TravelRule.CreateMessageAsync("11111111-2222-3333-4444-555555555555", new TravelRuleMessageCreateRequest { Kind = new TravelRuleMessageCreateRequestKind("DOCUMENT_REQUEST"), Body = "Please confirm the date of birth of the beneficiary.", RequestedDocuments = new string[] { "Proof of address" }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleMessageCreateRequest: type: object description: >- Senden Sie als JSON oder als multipart/form-data mit den Anhängen in `files`. properties: kind: type: string enum: - MESSAGE - DOCUMENT_REQUEST default: MESSAGE body: type: string maxLength: 5000 description: >- Erforderlich für eine MESSAGE, es sei denn, eine Datei ist angehängt. requested_documents: type: array items: type: string maxLength: 255 maxItems: 10 description: >- Erforderlich (mindestens eines) für einen DOCUMENT_REQUEST und nur dort zulässig. reply_to: type: string format: uuid nullable: true description: >- Eine Nachricht desselben Transfers. Eine Antwort, die ein Dokument enthält, erfüllt die Dokumentenanforderung, auf die sie antwortet. files: type: array items: type: string format: binary maxItems: 5 description: Nur Multipart. Bis zu 5 Dateien mit jeweils 10 MB. TravelRuleMessage: type: object properties: id: type: string format: uuid kind: type: string enum: - MESSAGE - DOCUMENT_REQUEST direction: type: string enum: - INBOUND - OUTBOUND description: >- `OUTBOUND` ist das, was die eigene Seite des Lesers gesendet hat. Im Abholportal entspricht die Richtung der Sicht der Gegenpartei. author: type: string description: >- Wer es auf der jeweiligen Seite verfasst hat: die E-Mail-Adresse eines Console-Benutzers, die Bezeichnung eines API-Schlüssels oder der Name des anderen VASP. body: type: string requested_documents: type: array items: type: string description: >- Was bei einem DOCUMENT_REQUEST angefordert wird, in den Worten des Anfragenden. reply_to: type: string format: uuid nullable: true fulfilled_at: type: string format: date-time nullable: true description: >- Wird für ein DOCUMENT_REQUEST gesetzt, sobald eine Antwort darauf ein Dokument enthält. attachment: $ref: '#/components/schemas/TravelRuleMessageAttachment' created_at: type: string format: date-time TravelRuleMessageAttachment: type: object nullable: true description: >- Das an eine Nachricht angehängte Dokument, gespeichert wie jedes andere Transaktionsdokument. properties: uuid: type: string format: uuid label: type: string nullable: true note: type: string nullable: true uploaded_by: type: string nullable: true description: >- Wer die Datei angehängt hat. Im Abrufportal zeigt eine von Ihnen gesendete Datei Ihren VASP-Namen, niemals die dahinterstehende Person oder den API-Schlüssel. created_at: type: string format: date-time files: type: array items: type: object properties: uuid: type: string format: uuid file_url: type: string nullable: true description: Zeitlich begrenzte Download-URL. original_filename: type: string file_size: type: integer 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.