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

# Contacts de contreparties - API Travel Rule par e-mail

> Liste les adresses de conformité auxquelles le canal e-mail Travel Rule peut écrire pour votre application : contacts Didit et vos contacts privés.



Prompt de l'API qui répertorie les contacts de la contrepartie
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\`List the compliance addresses Didit's Travel Rule EMAIL rail may write to for my application.

Endpoint:
GET https://verification.didit.me/v3/travel-rule/counterparty-contacts/

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

Query parameters:
\- counterparty (optional) - a directory entry id from GET /v3/travel-rule/vasps/. Must be a UUID; a value that is not one answers 400 {"counterparty": ["Must be a valid UUID."]}. An empty value means no filter.
\- limit (default 50), offset. The list is newest first; count stops at 100, so 100 means 100 or more.

What to read from each contact:
\- scope - platform (curated by Didit, or learned from an address at one of the VASP's own domains that answered; used for every Didit customer, read-only) or application (private to my application).
\- counterparty, counterparty_name, email, name.
\- source - staff (curated by Didit), learned (an address that answered a request through its response link: platform scope when it is at one of the VASP's own domains, otherwise application scope, private to the application whose request it answered) or application (added by my application).
\- verified_at - when the address last answered a request through its response link.
\- is_invalid, invalid_reason (hard_bounce | soft_bounce | spam_complaint | suppressed, empty while valid), invalid_detail, invalid_at - a bounced or complaining address is skipped by the EMAIL rail. A bounce marks only the contact it reached; suppressed marks every contact at an address Didit's email delivery stopped sending to (after a permanent bounce, a spam complaint or an unsubscribe), and those contacts are valid again once sending to the address resumes.
\- created_by - empty on platform contacts and on contacts an API key added.

Add a contact with POST /v3/travel-rule/counterparty-contacts/ and delete one of mine with DELETE /v3/travel-rule/counterparty-contacts/{contact_uuid}/.

Full guide: /transaction-monitoring/travel-rule#contacts.`

\</pre>



      
      

Coller dans



## OpenAPI

````yaml fr/openapi-25.json GET /v3/travel-rule/counterparty-contacts/
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/counterparty-contacts/:
    get:
      tags:
        - Travel Rule
      summary: Lister les contacts de la contrepartie
      description: >-
        Les adresses de conformité auxquelles le canal EMAIL peut écrire pour
        votre application : les contacts de la plateforme Didit ainsi que les
        contacts privés de votre application, y compris celles ayant généré un
        rebond, du plus récent au plus ancien. Paginé avec `limit` (50 par
        défaut) et `offset` ; `count` s'arrête à 100, donc 100 signifie 100 ou
        plus.
      operationId: listTravelRuleCounterpartyContacts
      parameters:
        - name: counterparty
          in: query
          schema:
            type: string
            format: uuid
          description: >-
            Uniquement les contacts de cette entrée de l'annuaire. Doit être un
            UUID ; une valeur vide signifie aucun filtre.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
          description: Taille de page, 50 par défaut.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
          description: Lignes à ignorer.
      responses:
        '200':
          description: Les contacts.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    nullable: true
                  previous:
                    type: string
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/TravelRuleCounterpartyContact'
              example:
                count: 1
                next: null
                previous: null
                results:
                  - uuid: 6c1f9b8e-2d4a-4f7e-8b3c-5a9d0e1f2a3b
                    counterparty: 0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91
                    counterparty_name: Example Counterparty VASP
                    email: compliance@counterparty.example
                    name: Compliance desk
                    source: application
                    scope: application
                    created_by: ''
                    verified_at: null
                    is_invalid: false
                    invalid_reason: ''
                    invalid_detail: ''
                    invalid_at: null
                    created_at: '2026-10-19T09:00:00Z'
        '400':
          description: '`counterparty` n''est pas un UUID.'
          content:
            application/json:
              example:
                counterparty:
                  - Must be a valid UUID.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/travel-rule/counterparty-contacts/?counterparty={vasp_id}'
            \
              -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.travel_rule.counterparty_contacts.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.travelRule.counterpartyContacts.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.TravelRule.CounterpartyContacts.ListAutoPaging(ctx, didit.TravelRuleCounterpartyContactsListParams{})\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.travelRule().counterpartyContacts().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            foreach ($didit->travelRule->counterpartyContacts->list() as $item)
            {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            didit.travel_rule.counterparty_contacts.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.TravelRule.CounterpartyContacts.ListAsync())

            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    TravelRuleCounterpartyContact:
      type: object
      description: >-
        Une adresse de conformité vers laquelle le canal EMAIL écrit pour une
        entrée de l'annuaire.
      properties:
        uuid:
          type: string
          format: uuid
        counterparty:
          type: string
          format: uuid
          description: >-
            Le champ `id` de l'entrée de l'annuaire, tel qu'affiché par GET
            /v3/travel-rule/vasps/.
        counterparty_name:
          type: string
        email:
          type: string
          format: email
        name:
          type: string
          description: Libellé optionnel, par exemple le nom de l'équipe.
        source:
          type: string
          enum:
            - staff
            - application
            - learned
          description: >-
            staff : sélectionné par Didit. learned : une adresse sur l'un des
            domaines propres du VASP ayant répondu à une requête via son lien de
            réponse. application : ajouté par votre application.
        scope:
          type: string
          enum:
            - platform
            - application
          description: >-
            platform : sélectionné par Didit ou déduit d'une réponse vérifiée,
            utilisé pour chaque client de Didit, en lecture seule pour vous.
            application : privé pour votre application.
        created_by:
          type: string
          description: >-
            Vide pour les contacts de la plateforme et pour les contacts ajoutés
            par une clé API.
        verified_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Date et heure auxquelles cette adresse a répondu pour la dernière
            fois à une requête via son lien de réponse.
        is_invalid:
          type: boolean
          description: >-
            true une fois que l'adresse a fait l'objet d'un rebond ou d'une
            réclamation ; le canal EMAIL l'ignore.
        invalid_reason:
          type: string
          enum:
            - ''
            - hard_bounce
            - soft_bounce
            - spam_complaint
            - suppressed
        invalid_detail:
          type: string
          description: >-
            Le motif du serveur de messagerie de réception, lorsqu'il en a
            fourni un.
        invalid_at:
          type: string
          format: date-time
          nullable: true
        created_at:
          type: string
          format: date-time
  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.