> ## 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. # API Transazioni Correlate: Elenco e Paginazione > Con Didit, elenca le altre transazioni della tua applicazione che condividono un vendor_data con una transazione monitorata, dalla più recente, con paginazione. Prompt API per elencare le transazioni correlate Copia il prompt negli appunti \

\`List the transactions related to one Didit monitored transaction through the Management API.

Endpoint:
GET https://verification.didit.me/v3/transactions/{transaction_id}/related/

Authentication:
Use the x-api-key header with my Didit API key. A scoped key needs transactions: read. Keys limited to specific workflows or to approved sessions cannot call this endpoint.

Goal:
\- See the other transactions that involve the same people or companies as this one (same applicant, or this transaction's counterparty appearing elsewhere) so I can review a transaction in context.

Path parameter:
\- transaction_id: the Didit transaction uuid, not my own txn_id.

Behavior:
\- A transaction is related when one of its parties, in any role, has the same vendor_data as one of this transaction's parties. Matching uses vendor_data only, within my application.
\- The transaction itself is never returned. Parties without vendor_data are ignored, so if none of this transaction's parties has a vendor_data the result is always empty.
\- Ordered by txn_date, newest first, then created_at.
\- Paginated with limit (default 50) and offset. count is exact up to 100 and capped at 100 above that, so keep following next until it is null.

Example call:
curl -X GET "https://verification.didit.me/v3/transactions/{transaction_id}/related/?limit=50" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- results[].uuid: use it with GET /v3/transactions/{transaction_id}/ for the full detail.
\- results[].txn_id, status, score, severity, amount, currency, txn_date: the summary of each related transaction.
\- results[].subject_vendor_data and counterparty_vendor_data: which party links it to this transaction.
\- next: URL of the next page, null on the last page.

Failure modes:
\- 400: limit or offset above 1000000.
\- 401: the API key has expired.
\- 403: missing API key (a wrong, revoked or expired key gets 401) ({"detail": "You do not have permission to perform this action."}), a scoped key without transactions: read, a key with workflow or status limits, or a request from outside the key's IP allowlist.
\- 404: no transaction with this uuid in my application ({"detail": "No Transaction matches the given query."}).
\- 429: more than 600 GET requests per minute with this key; wait Retry-After seconds and retry.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Incolla in Le transazioni correlate sono collegate tramite il `vendor_data` che invii per ciascuna parte quando [invii una transazione](https://docs.didit.me/it/transaction-monitoring/transactions.md#soggetto-e-controparte). Invia lo stesso `vendor_data` per la stessa persona o azienda ogni volta: questo endpoint restituisce la cronologia completa relativa a qualsiasi transazione, cioè la stessa lista che i revisori vedono sotto **Transazioni correlate** nel [dettaglio della transazione](https://docs.didit.me/it/transaction-monitoring/console.md#dettaglio-della-transazione) nella Console.Ogni risultato ha la stessa struttura di sintesi di [Elenca transazioni](https://docs.didit.me/it/management-api/transactions/list.md). Chiama [Recupera transazione](https://docs.didit.me/it/management-api/transactions/get.md) con l'`uuid` di un risultato per ottenere le sue parti, gli alert e le esecuzioni delle regole. ## OpenAPI ````yaml it/openapi-25.json GET /v3/transactions/{transaction_id}/related/ 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/transactions/{transaction_id}/related/: get: tags: - Transactions summary: Elenca le transazioni correlate description: >- Elenca le altre transazioni nella tua applicazione che coinvolgono le stesse persone o aziende di questa. Una transazione è correlata quando una qualsiasi delle sue parti, in qualsiasi ruolo, ha lo stesso `vendor_data` di una delle parti di questa transazione. La transazione stessa non viene mai restituita e le parti senza `vendor_data` vengono ignorate: se nessuna delle parti di questa transazione ne ha uno, il risultato è sempre vuoto. I risultati utilizzano il formato di riepilogo di `GET /v3/transactions/`, dalla più recente alla meno recente (`txn_date`, poi `created_at`). Impaginati con `limit` e `offset`; `count` è esatto fino a 100 e limitato a un massimo di 100 oltre tale valore, quindi segui `next` fino a quando non è `null`. Una chiave API con ambito limitato richiede `transactions: read`; una chiave limitata ad alcuni workflow o a sessioni approvate non può chiamare questo endpoint. Invia lo stesso `vendor_data` per la stessa persona o azienda in ogni [transazione](https://docs.didit.me/it/transaction-monitoring/transactions#soggetto-e-controparte) per rendere completo questo elenco. operationId: list_related_transactions parameters: - name: transaction_id in: path required: true description: >- UUID della transazione Didit: l'`uuid` restituito da `POST /v3/transactions/` e `GET /v3/transactions/`. Il tuo `txn_id` personale non è accettato. schema: type: string format: uuid example: abcdef12-3456-7890-abcd-ef1234567890 - name: limit in: query required: false schema: type: integer default: 50 minimum: 1 maximum: 1000000 description: >- Numero di transazioni per pagina. Il valore predefinito è 50. Un valore che non sia un numero intero positivo reimposta il valore a 50; un valore superiore a 1000000 restituisce `400`. - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Posizione in base zero della prima transazione da restituire. È preferibile seguire `next`. Un valore che non è un numero intero reimposta a 0; un valore superiore a 1000000 restituisce `400`. responses: '200': description: Una pagina di transazioni correlate, dalla più recente. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer description: >- Numero di transazioni correlate: esatto fino a 100, limitato a 100 al di sopra. Segui `next` invece di calcolare le pagine a partire da questo valore. next: type: string format: uri nullable: true description: >- URL assoluto della pagina successiva, o `null` sull'ultima pagina. previous: type: string format: uri nullable: true description: >- URL assoluto della pagina precedente, o `null` sulla prima pagina. results: type: array items: $ref: '#/components/schemas/TransactionSummary' examples: One related transaction: value: count: 1 next: null previous: null results: - uuid: abcdef99-3456-4890-abcd-ef1234567890 transaction_number: 4087 txn_id: your-txn-2026-10-02-017 transaction_type: finance action_type: deposit status: APPROVED source: LIVE direction: INBOUND amount: '250' currency: EUR currency_type: fiat preferred_currency_amount: '270.08' preferred_currency_code: USD payment_details: Card top-up txn_date: '2026-10-02T14:10:00Z' created_at: '2026-10-02T14:10:03.512244Z' score: 12 severity: LOW decision_reason_code: null decision_reason_label: null tags: [] subject_name: Maria Garcia subject_vendor_data: user-12345 subject_type: user subject_uuid: e1111111-2222-4333-8444-555555555555 counterparty_name: null counterparty_vendor_data: null counterparty_country: null subject_country: ESP assigned_to_name: null travel_rule_status: null application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee application_name: Production app organization_id: 11111111-2222-3333-4444-555555555555 organization_name: Example Org No party has vendor_data: value: count: 0 next: null previous: null results: [] '400': description: >- `limit` o `offset` è superiore a 1000000. Il corpo è un array JSON di messaggi, non un oggetto. content: application/json: schema: type: array items: type: string examples: Limit too large: value: - limit must not exceed 1000000. Offset too large: value: - offset must not exceed 1000000. '401': description: >- La chiave API è scaduta. Solo una chiave creata con una data di scadenza può scadere; dopo tale data ogni richiesta inviata con essa risponde con `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La richiesta non è consentita. Una chiave mancante riceve il messaggio generico; una chiave errata, revocata o scaduta riceve `401`. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: You do not have permission to perform this action. Scoped key without transactions read: value: detail: This API key has no read access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '404': description: >- Nessuna transazione con questo UUID esiste nell'applicazione (mai creata, eliminata o di proprietà di un'altra applicazione). Un `transaction_id` che non è un UUID non raggiunge l'API: restituisce una pagina HTML `404` invece di questo corpo JSON. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: No Transaction matches the given query. '429': description: >- Più di 600 richieste GET al minuto con questa chiave API. Attendi il numero di secondi indicato in `Retry-After`, quindi riprova. content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: >- Secondi fino al ripristino della finestra temporale corrente di un minuto. schema: type: integer example: 23 X-RateLimit-Limit: description: Richieste consentite al minuto per questo budget. schema: type: integer X-RateLimit-Remaining: description: Richieste rimanenti nell'intervallo corrente. schema: type: integer X-RateLimit-Reset: description: Ora Unix in cui la finestra si azzera. schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/related/?limit=50' \ -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.transactions.list_related( "abcdef12-3456-7890-abcd-ef1234567890", ): 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.transactions.listRelated("abcdef12-3456-7890-abcd-ef1234567890")) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Transactions.ListRelatedAutoPaging(ctx, \"abcdef12-3456-7890-abcd-ef1234567890\", didit.TransactionsListRelatedParams{})\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.transactions().listRelated("abcdef12-3456-7890-abcd-ef1234567890")) { System.out.println(item); } - lang: php label: PHP source: >- transactions->listRelated('abcdef12-3456-7890-abcd-ef1234567890') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.transactions.list_related("abcdef12-3456-7890-abcd-ef1234567890").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.Transactions.ListRelatedAsync("abcdef12-3456-7890-abcd-ef1234567890")) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: TransactionSummary: type: object description: >- Riepilogo di una transazione monitorata, nella struttura elencata da `GET /v3/transactions/`. Chiama `GET /v3/transactions/{transaction_id}/` con `uuid` per le parti, gli alert e le esecuzioni delle regole. properties: uuid: type: string format: uuid description: >- UUID della transazione Didit. Utilizzalo come `{transaction_id}` negli endpoint delle transazioni. transaction_number: type: integer nullable: true description: >- Numero sequenziale con ambito limitato all'applicazione mostrato nella Console. txn_id: type: string nullable: true description: >- Il tuo identificatore dalla chiamata di creazione. Univoco per applicazione. transaction_type: type: string description: >- Categoria come memorizzata: `finance`, `kyc`, `travelRule`, `userPlatformEvent`, `gamblingBet`, `gamblingLimitChange`, `gamblingBonusChange` o `auditTrailEvent`. action_type: type: string description: Sottotipo all'interno della categoria, ad esempio `withdrawal`. status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Verdetto di monitoraggio attuale. source: type: string enum: - LIVE - IMPORTED description: >- `LIVE` per le transazioni inviate per il monitoraggio, `IMPORTED` per le importazioni storiche. direction: type: string enum: - INBOUND - OUTBOUND description: Direzione rispetto al soggetto. amount: type: string description: >- Importo come stringa decimale senza zeri finali (fino a 18 cifre decimali). currency: type: string description: Codice valuta o simbolo dell'asset crypto di `amount`. currency_type: type: string nullable: true description: '`fiat` o `crypto` se noto.' preferred_currency_amount: type: string nullable: true description: >- `amount` convertito nella valuta preferita dell'applicazione, quando era disponibile un tasso di cambio. preferred_currency_code: type: string nullable: true description: Valuta di `preferred_currency_amount`. payment_details: type: string nullable: true description: Riferimento di pagamento in formato testo libero. txn_date: type: string format: date-time description: Quando è avvenuta la transazione. created_at: type: string format: date-time description: Quando Didit lo ha registrato. score: type: integer description: Punteggio di rischio. Più alto indica un rischio maggiore. severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL - null description: Gravità del rischio, `null` finché non viene impostata. decision_reason_code: type: string nullable: true description: Motivo leggibile dalla macchina per il `status` attuale. decision_reason_label: type: string nullable: true description: Etichetta di facile lettura per `decision_reason_code`. tags: type: array description: Tag sulla transazione. items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: Colore esadecimale, ad esempio `#F59E0B`. description: type: string nullable: true source: type: string enum: - didit - custom description: Tag predefinito Didit o personalizzato. subject_name: type: string nullable: true description: Nome completo della parte `APPLICANT`. subject_vendor_data: type: string nullable: true description: Il tuo `vendor_data` per il richiedente. subject_type: type: string nullable: true enum: - user - business - null description: >- Indica se il richiedente è collegato a un utente o a un'azienda di Didit; `null` quando non è collegato a nessuno dei due. subject_uuid: type: string format: uuid nullable: true description: >- UUID dell'utente o dell'azienda Didit a cui è collegato il richiedente. subject_country: type: string nullable: true description: Codice del paese del richiedente. counterparty_name: type: string nullable: true description: Nome completo della parte `COUNTERPARTY`, se presente. counterparty_vendor_data: type: string nullable: true description: Il tuo `vendor_data` per la controparte. counterparty_country: type: string nullable: true description: Codice del paese della controparte. assigned_to_name: type: string nullable: true description: Nome del revisore della Console assegnato alla transazione. travel_rule_status: type: string nullable: true description: >- Stato del trasferimento Travel Rule della transazione, o `null` se non ne ha nessuno. application_id: type: string format: uuid description: Applicazione a cui appartiene la transazione. application_name: type: string nullable: true description: Nome di tale applicazione. organization_id: type: string format: uuid description: Organizzazione proprietaria dell'applicazione. organization_name: type: string nullable: true description: Nome di tale organizzazione. 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.