> ## 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. # Elenco contatti controparte API Travel Rule via email > Elenca gli indirizzi di compliance che il canale email della Travel Rule di Didit può usare per la tua applicazione: contatti Didit e privati. Prompt API per l'elenco dei contatti delle controparti Copia il prompt negli appunti \

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

\
Incolla in ## OpenAPI ````yaml it/openapi-25.json GET /v3/travel-rule/counterparty-contacts/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/counterparty-contacts/: get: tags: - Travel Rule summary: Elenca i contatti della controparte description: >- Gli indirizzi di compliance a cui il canale EMAIL può scrivere per la tua applicazione: i contatti della piattaforma Didit più quelli privati della tua applicazione, inclusi quelli per i quali la consegna è fallita, dal più recente. Paginato con `limit` (predefinito 50) e `offset`; `count` si ferma a 100, quindi 100 indica 100 o più. operationId: listTravelRuleCounterpartyContacts parameters: - name: counterparty in: query schema: type: string format: uuid description: >- Solo i contatti di questa voce di directory. Deve essere un UUID; un valore vuoto indica nessun filtro. - name: limit in: query required: false schema: type: integer minimum: 1 description: Dimensione della pagina, valore predefinito 50. - name: offset in: query required: false schema: type: integer minimum: 0 description: Righe da saltare. responses: '200': description: I contatti. 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` non è 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: >- 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: >- Un indirizzo di compliance a cui la via EMAIL scrive per una voce della directory. properties: uuid: type: string format: uuid counterparty: type: string format: uuid description: >- L'`id` della voce della directory, come mostrato da GET /v3/travel-rule/vasps/. counterparty_name: type: string email: type: string format: email name: type: string description: Etichetta opzionale, ad esempio il nome del team. source: type: string enum: - staff - application - learned description: >- staff: curato da Didit. learned: un indirizzo presso uno dei domini propri del VASP che ha risposto a una richiesta tramite il relativo link di risposta. application: aggiunto dalla tua applicazione. scope: type: string enum: - platform - application description: >- platform: curato da Didit o appreso da una risposta verificata, utilizzato per ogni cliente Didit, in sola lettura per te. application: privato per la tua applicazione. created_by: type: string description: >- Vuoto per i contatti della piattaforma e per i contatti aggiunti da una chiave API. verified_at: type: string format: date-time nullable: true description: >- Quando questo indirizzo ha risposto l'ultima volta a una richiesta tramite il relativo link di risposta. is_invalid: type: boolean description: >- true quando l'indirizzo ha generato un bounce o un reclamo; il rail EMAIL lo salta. invalid_reason: type: string enum: - '' - hard_bounce - soft_bounce - spam_complaint - suppressed invalid_detail: type: string description: Il motivo fornito dal server di posta ricevente, se disponibile. 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 chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.