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

# واجهة برمجة تحليلات الحالات

> تحليلات الحالات من Didit: الحالات المُنشأة مقابل المُراجَعة، ومعدل التهديد، ومعدل الإيجابي الكاذب، وتوقيت SLA، وعمق قائمة الانتظار لحظياً.



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



      
      

\<pre>

\`Pull case analytics through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/statistics/

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

Query params:
\- date_from=YYYY-MM-DD (default: 30 days ago)
\- date_to=YYYY-MM-DD (default: today)
\- range cannot exceed 731 days; date_from must not be after date_to.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/statistics/?date_from=2026-06-01&date_to=2026-06-30" \
-H "x-api-key: YOUR_API_KEY"

Response 200 shape:
\{
"series": [{"date": "2026-06-01", "created": 4, "reviewed": 2}, ...],
"tables": {
"officer": [{"key": "officer@company.com", "created": ..., "resolved": ..., "threat_rate": ..., ...}, ...],
"blueprint": [{"key": "AML investigation:<uuid>", ...}, ...],
"source": [{"key": "MANUAL", ...}, ...],
"status": [{"key": "OPEN", ...}, ...]
},
"totals": {"created": ..., "assigned": ..., "resolved": ..., "threat_rate": ..., "false_positive_rate": ..., "unresolved": ..., "reassignment_rate": ..., "escalation_rate": ..., "avg_assign_hours": ..., "avg_resolve_hours": ..., "avg_handling_hours": ...},
"queue": {"open": 12, "overdue": 3}
}
Note: queue is a live snapshot, not scoped to date_from/date_to.

Failure modes:
\- 400 - invalid date format, date_from after date_to, or range over 731 days.
\- 401/403 - auth/permission errors (requires list:cases).

Side effects: none, pure read/aggregate.

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

\</pre>



      
      

الصق في

المقاييس المجمّعة التي تقف وراء علامتي التبويب [«نظرة عامة» و«التحليلات»](https://docs.didit.me/ar/console/case-management/analytics.md) في وحدة التحكم: سلسلة يومية تقارن بين عدد الحالات المنشأة وعدد الحالات التي تمت مراجعتها، وأربعة جداول تفصيلية، وإجماليات التجميع، وقائمة الانتظار الحالية للحالات المفتوحة والمتأخرة.## ذات صلة- [التحليلات (وحدة التحكم)](https://docs.didit.me/ar/console/case-management/analytics.md)
- [قائمة الحالات](https://docs.didit.me/ar/management-api/cases/list.md)


## OpenAPI

````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/statistics/
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}/cases/statistics/:
    get:
      tags:
        - Cases
      summary: تحليلات الحالة
      description: >-
        تحليلات الحالات المجمعة للنطاق الزمني (الافتراضي هو آخر 30 يوماً؛ بحد
        أقصى 731 يوماً). تستخدم المخططات البيانية والجداول والإجماليات وأحداث
        التعيين وعدد عناصر قائمة الانتظار الحالية نفس عوامل التصفية المخصصة
        للتطبيق. تستخدم عوامل التصفية قيم الحالة الحالية. تسري التواريخ على كل
        حدث مقياس، لذا تظل الحالات الأقدم التي تم تعيينها أو حلها خلال تلك
        الفترة مشمولة. عمق قائمة الانتظار مستقل عن النطاق الزمني. تُرجع عوامل
        التصفية غير الصالحة رمز 400؛ كما يُرجع المخطط التفصيلي أو المكلَّف غير
        المعروف نتيجة فارغة.
      operationId: get_case_analytics
      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: date_from
          in: query
          schema:
            type: string
            format: date
          description: بداية النطاق (شاملة). القيمة الافتراضية هي منذ 30 يوماً.
        - name: date_to
          in: query
          schema:
            type: string
            format: date
          description: نهاية النطاق (شاملة). القيمة الافتراضية هي اليوم.
        - name: blueprint
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: التصفية حسب UUID للمخطط الحالي.
        - name: assigned_to
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: التصفية حسب UUID للمستخدم المراجِع المعيّن حالياً.
        - name: priority
          in: query
          required: false
          schema:
            type: string
            enum:
              - LOW
              - MEDIUM
              - HIGH
          description: التصفية حسب أولوية الحالة الحالية.
        - name: source
          in: query
          required: false
          schema:
            type: string
            enum:
              - MANUAL
              - AML_SCREENING
              - TRANSACTION_RULE
              - WORKFLOW_BUILDER
          description: التصفية حسب مصدر إنشاء الحالة.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - OPEN
              - AWAITING_USER
              - RESOLVED
          description: التصفية حسب حالة الحالة الراهنة.
      responses:
        '200':
          description: payload التحليلات.
          content:
            application/json:
              schema:
                type: object
                properties:
                  series:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                        created:
                          type: integer
                        reviewed:
                          type: integer
                  tables:
                    type: object
                    properties:
                      officer:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                قيمة البُعد: البريد الإلكتروني للمسؤول، أو
                                "blueprint_name:uuid"، أو المصدر، أو الحالة.
                                وتكون "unassigned"/"none" للأبعاد المفقودة.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      blueprint:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                قيمة البُعد: البريد الإلكتروني للمسؤول، أو
                                "blueprint_name:uuid"، أو المصدر، أو الحالة.
                                وتكون "unassigned"/"none" للأبعاد المفقودة.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      source:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                قيمة البُعد: البريد الإلكتروني للمسؤول، أو
                                "blueprint_name:uuid"، أو المصدر، أو الحالة.
                                وتكون "unassigned"/"none" للأبعاد المفقودة.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      status:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                قيمة البُعد: البريد الإلكتروني للمسؤول، أو
                                "blueprint_name:uuid"، أو المصدر، أو الحالة.
                                وتكون "unassigned"/"none" للأبعاد المفقودة.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                  totals:
                    type: object
                    properties:
                      created:
                        type: integer
                      assigned:
                        type: integer
                      resolved:
                        type: integer
                      threat_rate:
                        type: number
                        format: float
                      false_positive_rate:
                        type: number
                        format: float
                      unresolved:
                        type: integer
                      reassignment_rate:
                        type: number
                        format: float
                      escalation_rate:
                        type: number
                        format: float
                      avg_assign_hours:
                        type: number
                        format: float
                      avg_resolve_hours:
                        type: number
                        format: float
                      avg_handling_hours:
                        type: number
                        format: float
                  queue:
                    type: object
                    description: لقطة مباشرة، غير مقيّدة بالنطاق الزمني.
                    properties:
                      open:
                        type: integer
                      overdue:
                        type: integer
      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/cases/statistics/?date_from=2026-06-01&date_to=2026-06-30'
            \
              -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()

            result = client.cases.retrieve_statistics()
            print(result)
        - 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();

            const result = await didit.cases.retrieveStatistics();
            console.log(result);
        - 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\nresult, err := client.Cases.RetrieveStatistics(ctx, didit.CasesRetrieveStatisticsParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

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

            var result = client.cases().retrieveStatistics();
            System.out.println(result);
        - 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();

            $result = $didit->cases->retrieveStatistics();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

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

            result = didit.cases.retrieve_statistics
            puts result.to_h
        - 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();

            var result = await client.Cases.RetrieveStatisticsAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  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.