> ## 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 para listar transacciones relacionadas > Didit lista las transacciones de tu aplicación que comparten vendor_data de una parte con una transacción monitorizada, de la más reciente y paginadas. Prompt de la API para listar transacciones relacionadas Copiar el prompt al portapapeles \

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

\
Pegar en Las transacciones relacionadas se vinculan mediante el `vendor_data` que envías para cada parte cuando [envías una transacción](https://docs.didit.me/es/transaction-monitoring/transactions.md#sujeto-y-contraparte). Envía siempre el mismo `vendor_data` para la misma persona o empresa, y este endpoint devolverá su historial completo en torno a cualquier transacción: la misma lista que los revisores ven en **Transacciones relacionadas** en el [detalle de la transacción](https://docs.didit.me/es/transaction-monitoring/console.md#detalle-de-la-transacción) en la Console.Cada resultado tiene la misma estructura de resumen que [Listar transacciones](https://docs.didit.me/es/management-api/transactions/list.md). Invoca [Obtener transacción](https://docs.didit.me/es/management-api/transactions/get.md) con el `uuid` de un resultado para ver sus partes, alertas y ejecuciones de reglas. ## OpenAPI ````yaml es/openapi-25.json GET /v3/transactions/{transaction_id}/related/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/{transaction_id}/related/: get: tags: - Transactions summary: Listar transacciones relacionadas description: >- Lista las demás transacciones de tu aplicación en las que intervienen las mismas personas o empresas que en esta. Una transacción está relacionada cuando cualquiera de sus partes, en cualquier rol, tiene el mismo `vendor_data` que una de las partes de esta transacción. La propia transacción nunca se devuelve, y las partes sin `vendor_data` se ignoran: cuando ninguna de las partes de esta transacción tiene uno, el resultado siempre está vacío. Los resultados usan el formato resumido de `GET /v3/transactions/`, de más reciente a más antiguo (`txn_date` y luego `created_at`). Se paginan con `limit` y `offset`; `count` es exacto hasta 100 y se limita a 100 por encima de esa cifra, así que sigue `next` hasta que sea `null`. Una clave de API con alcance limitado necesita `transactions: read`; una clave limitada a algunos flujos o a sesiones aprobadas no puede llamar a este endpoint. Envía el mismo `vendor_data` para la misma persona o empresa en cada [transacción](https://docs.didit.me/es/transaction-monitoring/transactions#sujeto-y-contraparte) para que esta lista esté completa. operationId: list_related_transactions parameters: - name: transaction_id in: path required: true description: >- UUID de transacción de Didit: el `uuid` que devuelven `POST /v3/transactions/` y `GET /v3/transactions/`. No se acepta tu propio `txn_id`. 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: >- Número de transacciones por página. El valor predeterminado es 50. Un valor que no sea un entero positivo se sustituye por 50; un valor superior a 1000000 devuelve `400`. - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Posición, empezando en cero, de la primera transacción que se devuelve. Es preferible seguir `next`. Un valor que no sea un número entero se toma como 0; un valor superior a 1000000 devuelve `400`. responses: '200': description: >- Una página de transacciones relacionadas, de la más reciente a la más antigua. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer description: >- Número de transacciones relacionadas: exacto hasta 100 y limitado a 100 por encima de esa cifra. Sigue `next` en lugar de calcular las páginas a partir de este valor. next: type: string format: uri nullable: true description: >- URL absoluta de la página siguiente, o `null` en la última página. previous: type: string format: uri nullable: true description: >- URL absoluta de la página anterior, o `null` en la primera página. 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` u `offset` supera 1000000. El cuerpo es un array JSON de mensajes, no un objeto. 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 clave de API ha expirado. Solo puede expirar una clave creada con fecha de caducidad; a partir de esa fecha, toda solicitud que la use responde `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La solicitud no está permitida. Si falta la clave, se recibe el mensaje genérico; una clave incorrecta, revocada o expirada recibe `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: >- No existe ninguna transacción con este UUID en la aplicación (nunca se creó, se eliminó o pertenece a otra aplicación). Un `transaction_id` que no es un UUID no llega a la API: devuelve una página HTML `404` en lugar de este cuerpo JSON. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: No Transaction matches the given query. '429': description: >- Más de 600 solicitudes GET por minuto con esta clave de API. Espera el número de segundos indicado en `Retry-After` y vuelve a intentarlo. 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: Segundos hasta que se reinicia la ventana actual de un minuto. schema: type: integer example: 23 X-RateLimit-Limit: description: Solicitudes permitidas por minuto en este presupuesto. schema: type: integer X-RateLimit-Remaining: description: Solicitudes restantes en la ventana actual. schema: type: integer X-RateLimit-Reset: description: Tiempo Unix en que se restablece la ventana. 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: >- Resumen de una transacción monitorizada, con la estructura que lista `GET /v3/transactions/`. Llama a `GET /v3/transactions/{transaction_id}/` con `uuid` para obtener las partes, las alertas y las ejecuciones de reglas. properties: uuid: type: string format: uuid description: >- UUID de transacción de Didit. Úsalo como `{transaction_id}` en los endpoints de transacciones. transaction_number: type: integer nullable: true description: >- Número secuencial dentro de la aplicación que se muestra en la consola. txn_id: type: string nullable: true description: >- Tu propio identificador de la llamada de creación. Único por aplicación. transaction_type: type: string description: >- Categoría tal como se almacena: `finance`, `kyc`, `travelRule`, `userPlatformEvent`, `gamblingBet`, `gamblingLimitChange`, `gamblingBonusChange` o `auditTrailEvent`. action_type: type: string description: Subtipo dentro de la categoría, por ejemplo `withdrawal`. status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Veredicto de monitorización actual. source: type: string enum: - LIVE - IMPORTED description: >- `LIVE` para las transacciones enviadas a monitorización, `IMPORTED` para las importaciones históricas. direction: type: string enum: - INBOUND - OUTBOUND description: Sentido respecto al sujeto. amount: type: string description: Importe como cadena decimal sin ceros finales (hasta 18 decimales). currency: type: string description: Código de moneda o símbolo del criptoactivo de `amount`. currency_type: type: string nullable: true description: '`fiat` o `crypto` cuando se conoce.' preferred_currency_amount: type: string nullable: true description: >- `amount` convertido a la moneda preferida de la aplicación, cuando había un tipo de cambio disponible. preferred_currency_code: type: string nullable: true description: Moneda de `preferred_currency_amount`. payment_details: type: string nullable: true description: Referencia de pago en texto libre. txn_date: type: string format: date-time description: Cuándo se produjo la transacción. created_at: type: string format: date-time description: Cuándo lo registró Didit. score: type: integer description: Puntuación de riesgo. Cuanto más alta, mayor riesgo. severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL - null description: Gravedad del riesgo; `null` hasta que algo la establezca. decision_reason_code: type: string nullable: true description: Motivo legible por máquina del `status` actual. decision_reason_label: type: string nullable: true description: Etiqueta legible de `decision_reason_code`. tags: type: array description: Etiquetas de la transacción. items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: Color hexadecimal, por ejemplo `#F59E0B`. description: type: string nullable: true source: type: string enum: - didit - custom description: Etiqueta predefinida de Didit o personalizada. subject_name: type: string nullable: true description: Nombre completo de la parte `APPLICANT`. subject_vendor_data: type: string nullable: true description: Tu `vendor_data` para el solicitante. subject_type: type: string nullable: true enum: - user - business - null description: >- Si el solicitante está vinculado a un usuario o a una empresa de Didit; `null` cuando no está vinculado a ninguno. subject_uuid: type: string format: uuid nullable: true description: >- UUID del usuario o la empresa de Didit al que está vinculado el solicitante. subject_country: type: string nullable: true description: Código de país del solicitante. counterparty_name: type: string nullable: true description: Nombre completo de la parte `COUNTERPARTY`, si la hay. counterparty_vendor_data: type: string nullable: true description: Tu `vendor_data` para la contraparte. counterparty_country: type: string nullable: true description: Código de país de la contraparte. assigned_to_name: type: string nullable: true description: Nombre del revisor de la consola asignado a la transacción. travel_rule_status: type: string nullable: true description: >- Estado de la transferencia de Travel Rule de la transacción, o `null` cuando no tiene ninguna. application_id: type: string format: uuid description: Aplicación a la que pertenece la transacción. application_name: type: string nullable: true description: Nombre de esa aplicación. organization_id: type: string format: uuid description: Organización propietaria de la aplicación. organization_name: type: string nullable: true description: Nombre de esa organización. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.