> ## 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 > Список других транзакций приложения с тем же vendor_data стороны, что и у отслеживаемой транзакции в Didit, от новых к старым, с пагинацией. Промпт API для получения связанных транзакций Скопировать промпт в буфер обмена \

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

\
Вставьте в Связь между транзакциями определяется через `vendor_data`, который вы передаёте для каждой стороны при [отправке транзакции](https://docs.didit.me/ru/transaction-monitoring/transactions.md#субъект-и-контрагент). Передавайте один и тот же `vendor_data` для одного и того же человека или компании при каждом запросе, и этот endpoint вернёт полную историю транзакций этого человека или компании, связанных с любой отдельной транзакцией: тот же список, который проверяющие видят в разделе **Связанные транзакции** на [странице транзакции](https://docs.didit.me/ru/transaction-monitoring/console.md#детали-транзакции) в Консоли.Каждый результат имеет такую же краткую структуру, как и результаты [Списка транзакций](https://docs.didit.me/ru/management-api/transactions/list.md). Вызовите [Получить транзакцию](https://docs.didit.me/ru/management-api/transactions/get.md) с `uuid` результата, чтобы получить его стороны, оповещения и запуски правил. ## OpenAPI ````yaml ru/openapi-25.json GET /v3/transactions/{transaction_id}/related/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/{transaction_id}/related/: get: tags: - Transactions summary: Получить список связанных транзакций description: >- Получить список других транзакций в вашем приложении, в которых участвуют те же лица или компании, что и в этой. Транзакция считается связанной, если у любой из её сторон в любой роли совпадает `vendor_data` с одной из сторон этой транзакции. Сама транзакция никогда не возвращается, а стороны без `vendor_data` игнорируются: если ни у одной из сторон этой транзакции нет такого значения, результат всегда пуст. Результаты возвращаются в формате кратких сведений `GET /v3/transactions/`, сначала новые (`txn_date`, затем `created_at`). Поддерживается пагинация с помощью `limit` и `offset`; `count` является точным до 100 и ограничен 100 выше этого значения, поэтому переходите по `next`, пока оно не станет `null`. API-ключу с ограниченной областью видимости требуется `transactions: read`; ключ, ограниченный определёнными сценариями или одобренными сессиями, не может вызывать этот endpoint. Передавайте один и тот же `vendor_data` для одного и того же физического лица или компании в каждой [транзакции](https://docs.didit.me/ru/transaction-monitoring/transactions#субъект-и-контрагент), чтобы этот список был полным. operationId: list_related_transactions parameters: - name: transaction_id in: path required: true description: >- UUID транзакции Didit: значение `uuid`, возвращаемое методами `POST /v3/transactions/` и `GET /v3/transactions/`. Собственный `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: >- Количество транзакций на страницу. По умолчанию 50. Если значение не является положительным целым числом, используется 50; при значении выше 1000000 возвращается `400`. - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Позиция первой возвращаемой транзакции, начиная с нуля. Рекомендуется переходить по ссылке `next`. Значение, не являющееся целым неотрицательным числом, сбрасывается на 0; значение больше 1000000 возвращает `400`. responses: '200': description: Страница связанных транзакций, начиная с самых новых. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer description: >- Количество связанных транзакций: точное значение до 100, с ограничением 100 выше этого порога. Переходите по `next` вместо вычисления страниц на основе этого значения. next: type: string format: uri nullable: true description: >- Абсолютный URL следующей страницы или `null` на последней странице. previous: type: string format: uri nullable: true description: >- Абсолютный URL предыдущей страницы или `null` на первой странице. 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` или `offset` превышает 1000000. Тело ответа представляет собой JSON-массив сообщений, а не объект. 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: >- Срок действия API-ключа истёк. Истечь может только ключ, созданный со сроком действия; после этой даты каждый запрос с ним возвращает `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- Запрос запрещён. При отсутствии ключа возвращается стандартное сообщение; при неверном, отозванном или истёкшем ключе возвращается `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: >- Транзакция с этим UUID не существует в приложении (никогда не создавалась, удалена или принадлежит другому приложению). Значение `transaction_id`, не являющееся UUID, не доходит до API: вместо этого возвращается HTML-страница `404`, а не это JSON-тело. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: No Transaction matches the given query. '429': description: >- Более 600 GET-запросов в минуту с этим API-ключом. Подождите указанное в `Retry-After` количество секунд, затем повторите попытку. 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: Количество секунд до сброса текущего минутного окна. schema: type: integer example: 23 X-RateLimit-Limit: description: Количество разрешённых запросов в минуту в рамках этого бюджета. schema: type: integer X-RateLimit-Remaining: description: Количество оставшихся запросов в текущем окне. schema: type: integer X-RateLimit-Reset: description: Unix-время, когда окно сбрасывается. 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: >- Сводка отслеживаемой транзакции со структурой, описанной в `GET /v3/transactions/`. Вызовите `GET /v3/transactions/{transaction_id}/` с `uuid` для получения сторон, оповещений и срабатываний правил. properties: uuid: type: string format: uuid description: >- UUID транзакции Didit. Используйте его в качестве `{transaction_id}` в endpoint'ах транзакций. transaction_number: type: integer nullable: true description: Порядковый номер в рамках приложения, отображаемый в консоли. txn_id: type: string nullable: true description: >- Ваш собственный идентификатор из вызова создания. Уникален для каждого приложения. transaction_type: type: string description: >- Категория в сохранённом виде: `finance`, `kyc`, `travelRule`, `userPlatformEvent`, `gamblingBet`, `gamblingLimitChange`, `gamblingBonusChange` или `auditTrailEvent`. action_type: type: string description: Подтип внутри категории, например `withdrawal`. status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Текущий вердикт мониторинга. source: type: string enum: - LIVE - IMPORTED description: >- `LIVE` для транзакций, отправленных на мониторинг, `IMPORTED` для исторического импорта. direction: type: string enum: - INBOUND - OUTBOUND description: Направление относительно субъекта. amount: type: string description: >- Сумма в виде десятичной строки с удалёнными замыкающими нулями (до 18 знаков после запятой). currency: type: string description: Код валюты или символ криптоактива для `amount`. currency_type: type: string nullable: true description: '`fiat` или `crypto`, если известно.' preferred_currency_amount: type: string nullable: true description: >- Значение `amount`, конвертированное в предпочтительную валюту приложения, если курс был доступен. preferred_currency_code: type: string nullable: true description: Валюта для `preferred_currency_amount`. payment_details: type: string nullable: true description: Назначение платежа в виде произвольного текста. txn_date: type: string format: date-time description: Когда произошла транзакция. created_at: type: string format: date-time description: Когда Didit записал это. score: type: integer description: Оценка риска. Чем выше, тем рискованнее. severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL - null description: Серьёзность риска, `null`, пока значение не установлено. decision_reason_code: type: string nullable: true description: Машиночитаемая причина текущего `status`. decision_reason_label: type: string nullable: true description: Понятная метка для `decision_reason_code`. tags: type: array description: Теги транзакции. items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: Шестнадцатеричный цвет (hex), например `#F59E0B`. description: type: string nullable: true source: type: string enum: - didit - custom description: Предустановленный или пользовательский тег Didit. subject_name: type: string nullable: true description: Полное имя стороны `APPLICANT`. subject_vendor_data: type: string nullable: true description: Ваш `vendor_data` для заявителя. subject_type: type: string nullable: true enum: - user - business - null description: >- Связан ли заявитель с пользователем или компанией Didit; `null`, если он не связан ни с тем, ни с другим. subject_uuid: type: string format: uuid nullable: true description: UUID пользователя или компании Didit, с которыми связан заявитель. subject_country: type: string nullable: true description: Код страны заявителя. counterparty_name: type: string nullable: true description: Полное имя стороны `COUNTERPARTY`, если применимо. counterparty_vendor_data: type: string nullable: true description: Ваш `vendor_data` для контрагента. counterparty_country: type: string nullable: true description: Код страны контрагента. assigned_to_name: type: string nullable: true description: Имя проверяющего в Console, назначенного на транзакцию. travel_rule_status: type: string nullable: true description: Статус передачи Travel Rule для транзакции, или `null`, если её нет. application_id: type: string format: uuid description: Приложение, которому принадлежит транзакция. application_name: type: string nullable: true description: Название этого приложения. organization_id: type: string format: uuid description: Организация, владеющая приложением. organization_name: type: string nullable: true description: Название этой организации. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.