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

# سجل تسليم Travel Rule عبر API

> اطّلع على سجل تسليم Travel Rule الكامل في Didit لمعاملة ما، مع الترقيم الصفحي وأنواع النقل وحالة الرسائل وأوقات التسليم.

موجّه API لسجل تسليم Travel Rule
نسخ الموجّه إلى الحافظة

<pre>
  \`Read the complete Travel Rule delivery history for one transaction.

  Endpoint:
  GET [https://verification.didit.me/v3/transactions/\{transaction\_id}/travel-rule/deliveries/](https://verification.didit.me/v3/transactions/\{transaction_id}/travel-rule/deliveries/)

  Authentication:
  Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid on my application. The key needs transaction read permission.

  Query parameters:

  * limit - entries per page, default 100; larger values are capped at 100, and a value above 1,000,000 returns 400.
  * offset - entries to skip, default 0, up to 1,000,000; a larger value returns 400.

  What to read from the response:

  * count, next, previous, results. count is capped at 100 and is not a reliable total for larger histories; follow next until it is null.
  * Entries are ordered oldest first, then by identifier for ties. Each has uuid, kind (SEND, ANSWER, TXID, CANCEL, POLL), status (QUEUED, SENDING, RETRYING, DELIVERED, FAILED), rail (EMAIL, TRP, INTERNAL, NETWORK, or null before selection), created\_at, delivered\_at and detail\_lines.
  * detail\_lines describes the message kind and status without transport payloads or raw errors. The rail is supplier-neutral: NETWORK collapses every named network into one value.

  Transaction detail embeds only the newest 100 entries as travel\_rule.deliveries, with travel\_rule.deliveries\_truncated when older ones were omitted. Transaction lists omit both fields. travel\_rule.delivery remains the newest entry only.

  Failure modes:

  * 400 - limit or offset above 1,000,000.
  * 401 - a wrong, revoked or expired API key.
  * 403 - the x-api-key header is missing, or the key lacks transaction read permission.
  * 404 - unknown transaction, no Travel Rule transfer, or a deleted transaction.

  Full guide: /transaction-monitoring/travel-rule#delivery-and-retries.\`
</pre>

الصق في

تُعيد واجهة API لسجل تسليم Travel Rule من Didit كل إدخال تسليم لمعاملة ما، مقسّمةً إلى صفحات من الأقدم إلى الأحدث.

استخدم `x-api-key` الخاص بك مع إذن قراءة المعاملات. `transaction_id` هو معرّف UUID للمعاملة في Didit. إذا لم يُعثر على المعاملة أو عملية التحويل، تُعيد الواجهة `404`؛ وإذا كان الإذن غير كافٍ، تُعيد `403`.

## التقسيم إلى صفحات وترتيب النتائج

تحتوي الاستجابة على `count` و`next` و`previous` و`results`. القيمة الافتراضية لـ `limit` هي 100 والحد الأقصى لها 100، أما `offset` فقيمته الافتراضية صفر ولا يجوز أن تتجاوز 1,000,000، وتُرجع الاستجابة `400` عند تجاوزها ذلك. عادةً ما يقتصر `count` على 100، ولا يمثل إجمالياً موثوقاً للسجلات التاريخية الأكبر حجماً. تابع `next` حتى يصبح `null`، بصرف النظر عن قيمة `count`. تُرتَّب العناصر حسب وقت الإنشاء، ثم حسب المعرّف عند التساوي.

يحتوي كل عنصر على `uuid` و`kind` و`status` و`rail` و`created_at` و`delivered_at` و`detail_lines`. تأخذ `rail` إحدى القيم `EMAIL` أو `TRP` أو `INTERNAL` أو `NETWORK` أو `null`، وتكون قبل الاختيار بلا قيمة. تصف `detail_lines` نوع الرسالة وحالتها، دون الأخطاء الخام أو payloads النقل.

## السجل المضمّن

تتضمّن [تفاصيل المعاملة](https://docs.didit.me/ar/management-api/transactions/get.md) أحدث 100 إدخال فقط في `travel_rule.deliveries`، مرتّبة من الأقدم إلى الأحدث. يخبرك الحقل `deliveries_truncated` ما إذا كانت إدخالات أقدم قد استُبعدت. تُغفِل قوائم المعاملات هذين الحقلين الخاصين بالسجل. ويظل الحقل الموجود `delivery` يصف أحدث تسليم.

راجع [التسليم وإعادة المحاولة](https://docs.didit.me/ar/transaction-monitoring/travel-rule.md#التسليم-وإعادة-المحاولة) لمعرفة معاني الحالات. [رسائل الطرف المقابل](https://docs.didit.me/ar/management-api/travel-rule/list-messages.md) هي endpoint منفصل للمحادثة.


## OpenAPI

````yaml ar/openapi-25.json GET /v3/transactions/{transaction_id}/travel-rule/deliveries/
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}/travel-rule/deliveries/:
    get:
      tags:
        - Travel Rule
      summary: عرض سجل تسليم Travel Rule
      description: >-
        اقرأ سجل التسليم الكامل لمعاملة، من الأقدم إلى الأحدث. يتطلب صلاحية
        قراءة المعاملات. على عكس أحدث 100 إدخال المضمّنة في التفاصيل، تُقسّم
        نقطة النهاية هذه السجل الكامل إلى صفحات. راجع [سجل
        التسليم](/ar/management-api/travel-rule/list-deliveries).
      operationId: listTravelRuleDeliveries
      parameters:
        - name: transaction_id
          in: path
          required: true
          description: معرّف UUID الثابت للمعاملة من Didit التي تملك التحويل.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 100
          description: >-
            عدد الإدخالات في كل صفحة. القيمة الافتراضية 100، والقيم الأكبر
            تُخفَّض إلى 100؛ والقيمة التي تتجاوز 1,000,000 تعيد `400`.
        - name: offset
          in: query
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            default: 0
          description: >-
            عدد الإدخالات المراد تخطيها، بحد أقصى 1,000,000. تُرجع القيمة الأكبر
            من ذلك الرمز `400`.
      responses:
        '200':
          description: سجل التسليم المقسّم إلى صفحات، من الأقدم إلى الأحدث.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleDeliveryLogPage'
              example:
                count: 1
                next: null
                previous: null
                results:
                  - uuid: 11111111-2222-4333-8444-555555555555
                    kind: SEND
                    status: DELIVERED
                    rail: NETWORK
                    created_at: '2026-11-01T10:00:00Z'
                    delivered_at: '2026-11-01T10:00:01Z'
                    detail_lines:
                      - Send
                      - Delivered
        '400':
          description: تم إرسال قيمة `limit` أو `offset` أكبر من 1,000,000.
        '401':
          description: مفتاح API غير صحيح أو ملغى أو منتهي الصلاحية.
        '403':
          description: >-
            مفتاح API مفقود أو غير صالح أو ملغى، أو لا يمكن للمفتاح قراءة
            معاملات هذا التطبيق. يعيد المفتاح المفقود `403`؛ بينما يعيد المفتاح
            الخاطئ أو الملغى أو منتهي الصلاحية `401`.
        '404':
          description: لم يتم العثور على المعاملة أو حوالة Travel Rule.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/transactions/11111111-2222-3333-4444-555555555555/travel-rule/deliveries/?limit=100&offset=0'
            \
              -H 'x-api-key: YOUR_API_KEY'
components:
  schemas:
    TravelRuleDeliveryLogPage:
      type: object
      required:
        - count
        - next
        - previous
        - results
      properties:
        count:
          type: integer
          minimum: 0
          description: >-
            يُحدَّد العدد عادةً بحد أقصى قدره 100، وليس إجمالياً موثوقاً للسجلات
            الأكبر حجماً. تابع next حتى تصبح القيمة null، بغض النظر عن count.
        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/TravelRuleDeliveryLogEntry'
          description: >-
            الإدخالات مرتبة من الأقدم إلى الأحدث حسب وقت الإنشاء، ثم حسب
            المعرّف.
    TravelRuleDeliveryLogEntry:
      type: object
      description: إدخال واحد محايد عن المزوّد في سجل التسليم.
      required:
        - uuid
        - kind
        - status
        - rail
        - created_at
        - delivered_at
        - detail_lines
      properties:
        uuid:
          type: string
          format: uuid
          description: معرّف التسليم.
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            ما تحمله الرسالة. `SEND`: أول رسالة للتحويل تُرسل إلى الطرف المقابل
            (صادرة؛ يتم اختيار المسار عند إرسالها). `ANSWER`: قبولك أو رفضك،
            المرسل إلى الشبكة التي قدمت الطلب (واردة). `TXID`: تجزئة المعاملة
            على السلسلة، بعد إنهاء التحويل. `CANCEL`: الإلغاء، بعد إلغائه.
            `POLL`: استعلام عن الحالة إلى شبكة تتيح ذلك، ويتكرر كل 5 دقائق أثناء
            انتظار التحويل للطرف المقابل.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: حالة التسليم الحالية.
        rail:
          type: string
          nullable: true
          enum:
            - EMAIL
            - TRP
            - INTERNAL
            - NETWORK
            - null
          description: نوع النقل المحايد تجاه المزوّد؛ لا قيمة له حتى يتم الاختيار.
        created_at:
          type: string
          format: date-time
          description: وقت إنشاء التسليم.
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: موعد اكتمال التسليم، أو null.
        detail_lines:
          type: array
          items:
            type: string
          description: >-
            نوع الرسالة وحالة التسليم بصيغة مقروءة للإنسان. لا تكشف عن payload
            النقل أو الأخطاء الخام.
      example:
        uuid: 11111111-2222-4333-8444-555555555555
        kind: SEND
        status: DELIVERED
        rail: NETWORK
        created_at: '2026-11-01T10:00:00Z'
        delivered_at: '2026-11-01T10:00:01Z'
        detail_lines:
          - Send
          - Delivered
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console.
        يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا
        شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات
        المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن
        المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم
        إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو
        الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير
        404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة
        بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL
        للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك
        إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع
        https://docs.didit.me/console/api-keys.

````

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