> ## 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، مع إمكانية التصفية حسب الوضع ونوع التقرير والحالة.



موجّه واجهة برمجة التطبيقات لقائمة التقارير
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\`List FIU reports across the application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/regulatory-reports/

Authentication:
Use the x-api-key header with my Didit API key.

Query params:
\- limit (default 50), offset (default 0)
\- status=DRAFT|VALIDATED|FINALIZED
\- report_type=SAR|STR|CTR|TTR|UTR|IFT|CBR|TFR
\- case=<case-uuid>

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/regulatory-reports/?status=DRAFT" \
-H "x-api-key: YOUR_API_KEY"

Response 200: {"count", "next", "previous", "results": [RegulatoryReportDetail, ...]}

Failure modes:
\- 401/403 - auth/permission errors (requires read:cases).

Side effects: none, pure read.

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

\</pre>



      
      

الصق في

أدرج التقارير على مستوى التطبيق بالكامل، وهي البيانات نفسها التي تعرضها صفحة التقارير المستقلة في Console. هذا هو endpoint الذي يمكنك استدعاؤه بشكل متكرر للحصول على قائمة انتظار من التقارير من نوع DRAFT التي تنتظر التحقق والإنهاء.## ذات صلة- [إنشاء تقرير مستقل](https://docs.didit.me/ar/management-api/regulatory-reports/create-for-case.md)
- [التحقق من التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/validate.md)
- [إنهاء التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/finalize.md)
- [تنزيل التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/download-url.md)
- [حذف التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/delete.md)


## OpenAPI

````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/
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/organization/{organization_id}/application/{application_id}/regulatory-reports/:
    get:
      tags:
        - Regulatory Reports
      summary: عرض التقارير
      description: >-
        قائمة تقارير وحدة المعلومات المالية (FIU) على مستوى التطبيق، وتتم
        تصفيتها اختيارياً حسب الحالة، أو نوع التقرير، أو الحالة المحددة.
      operationId: list_regulatory_reports
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID الخاص بالمؤسسة.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: معرّف UUID للتطبيق.
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
          description: حجم الصفحة.
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
          description: إزاحة تستند إلى الصفر.
        - name: status
          in: query
          schema:
            type: string
            enum:
              - DRAFT
              - VALIDATED
              - FINALIZED
          description: التصفية حسب الحالة.
        - name: report_type
          in: query
          schema:
            type: string
            enum:
              - SAR
              - STR
              - CTR
              - TTR
              - UTR
              - IFT
              - CBR
              - TFR
          description: التصفية حسب نوع التقرير.
        - name: case
          in: query
          schema:
            type: string
            format: uuid
          description: التصفية للتقارير المتعلقة بهذه الحالة.
      responses:
        '200':
          description: تقارير مقسمة إلى صفحات على مستوى التطبيق.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegulatoryReportList'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/regulatory-reports/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            client = Didit()

            for item in client.regulatory_reports.list():
                print(item)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            const didit = new Didit();

            for await (const item of didit.regulatoryReports.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\niter := client.RegulatoryReports.ListAutoPaging(ctx, didit.RegulatoryReportsListParams{})\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_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            Didit client = new Didit();

            for (var item : client.regulatoryReports().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            foreach ($didit->regulatoryReports->list() as $item) {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            didit = Didit::Client.new

            didit.regulatory_reports.list.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, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            using var client = new DiditClient();


            await foreach (var item in await
            client.RegulatoryReports.ListAsync())

            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    RegulatoryReportList:
      type: object
      properties:
        count:
          type: integer
          description: عدد الصفوف المتطابقة، بحد أقصى 100 لتحسين الأداء.
        next:
          type: string
          nullable: true
        previous:
          type: string
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/RegulatoryReportDetail'
    RegulatoryReportDetail:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        case_uuid:
          type: string
          format: uuid
        case_number:
          type: string
          nullable: true
        report_type:
          type: string
          enum:
            - SAR
            - STR
            - CTR
            - TTR
            - UTR
            - IFT
            - CBR
            - TFR
        report_type_display:
          type: string
        report_code:
          type: string
          description: رمز تقرير goAML المشتق من report_type، مثل STR، وCTR، وBCR.
        report_number:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - DRAFT
            - VALIDATED
            - FINALIZED
        status_display:
          type: string
        jurisdiction:
          type: string
          minLength: 2
          maxLength: 2
        rentity_id:
          type: string
          nullable: true
          description: معرّف الجهة المُبلِغة الصادر عن وحدة الاستخبارات المالية (FIU).
        rentity_branch:
          type: string
          nullable: true
        submission_code:
          type: string
          enum:
            - E
            - M
        entity_reference:
          type: string
          nullable: true
        fiu_ref_number:
          type: string
          nullable: true
        currency_code_local:
          type: string
          minLength: 3
          maxLength: 3
          nullable: true
        submission_date:
          type: string
          format: date-time
          nullable: true
        reporting_person:
          type: object
        location:
          type: object
        reason:
          type: string
          nullable: true
        action:
          type: string
          nullable: true
        activity:
          type: string
          nullable: true
        narrative:
          type: object
          description: أقسام السرد للأسئلة الخمسة (Five Ws).
          properties:
            who:
              type: string
            what:
              type: string
            when:
              type: string
            where:
              type: string
            why:
              type: string
            how:
              type: string
        report_indicators:
          type: array
          items:
            type: string
        included_fields:
          type: array
          items:
            type: string
        transactions:
          type: array
          items:
            type: string
            format: uuid
        validation_errors:
          type: array
          description: نتيجة آخر عملية تحقق من الصحة؛ كل إدخال هو كائن {field, message}.
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
        validated_at:
          type: string
          format: date-time
          nullable: true
        finalized_at:
          type: string
          format: date-time
          nullable: true
        created_by_email:
          type: string
          nullable: true
        created_by_name:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  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.