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

> Didit के साथ, निगरानी किए गए लेन-देन के समान पक्ष vendor_data वाले अन्य लेन-देन नवीनतम पहले और पृष्ठांकित रूप में सूचीबद्ध करें।



संबंधित लेन-देन सूची API प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

\<pre>

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

\</pre>



      
      

यहाँ पेस्ट करें

संबंधित लेन-देन उस `vendor_data` के ज़रिए जुड़े होते हैं जो आप हर पक्ष के लिए [लेन-देन सबमिट करते समय](https://docs.didit.me/hi/transaction-monitoring/transactions.md#विषय-और-प्रतिपक्ष) भेजते हैं। एक ही व्यक्ति या कंपनी के लिए हर बार एक ही `vendor_data` भेजें, और यह endpoint किसी भी एक लेन-देन से संबंधित उनका पूरा इतिहास लौटाता है: वही सूची जो समीक्षक Console में [लेन-देन विवरण](https://docs.didit.me/hi/transaction-monitoring/console.md#लेन-देन-विवरण) पर **संबंधित लेन-देन** के अंतर्गत देखते हैं।हर परिणाम में वही सारांश संरचना होती है जो [लेन-देन सूची](https://docs.didit.me/hi/management-api/transactions/list.md) में है। किसी परिणाम के `uuid` के साथ [लेन-देन प्राप्त करें](https://docs.didit.me/hi/management-api/transactions/get.md) कॉल करें ताकि उसके पक्ष, अलर्ट और नियमों के निष्पादन मिल सकें।


## OpenAPI

````yaml hi/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 को कॉल नहीं कर
        सकती है। इस सूची को पूर्ण बनाने के लिए प्रत्येक
        [लेन-देन](https://docs.didit.me/hi/transaction-monitoring/transactions#विषय-और-प्रतिपक्ष)
        पर एक ही व्यक्ति या कंपनी के लिए समान `vendor_data` भेजें।
      operationId: list_related_transactions
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: >-
            Didit लेन-देन UUID: `POST /v3/transactions/` और `GET
            /v3/transactions/` द्वारा लौटाया गया `uuid`। आपकी अपनी `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 तक नहीं पहुंचता है: यह इस JSON
            बॉडी के बजाय `404` HTML पेज लौटाता है।
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                Not found:
                  value:
                    detail: No Transaction matches the given query.
        '429':
          description: >-
            इस API कुंजी के साथ प्रति मिनट 600 से अधिक GET अनुरोध। `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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            foreach
            ($didit->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/`
        सूचीबद्ध करता है। पार्टियों, अलर्ट और नियम निष्पादन के लिए `uuid` के साथ
        `GET /v3/transactions/{transaction_id}/` को कॉल करें।
      properties:
        uuid:
          type: string
          format: uuid
          description: >-
            Didit लेन-देन UUID। लेन-देन endpoints पर इसका उपयोग
            `{transaction_id}` के रूप में करें।
        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: विषय (subject) के सापेक्ष दिशा।
        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: हेक्साडेसिमल रंग, उदाहरण के लिए `#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: Didit उपयोगकर्ता या व्यवसाय का UUID जिससे आवेदक जुड़ा हुआ है।
        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 कुंजी, Business Console में Developers -> API keys
        से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप
        किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या
        स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक
        सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी
        समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी,
        कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP
        सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी
        के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को
        छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write
        के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं।
        देखें https://docs.didit.me/console/api-keys।

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.