> ## 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 के साथ स्थिति, प्राथमिकता, स्रोत, ब्लूप्रिंट, असाइनी, टैग और देय तिथि से अनुपालन केस सूचीबद्ध करें; विषय, टैग और लिंक्ड इकाइयों पर पूर्ण-पाठ खोज।



केस सूची API प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

\<pre>

\`List compliance cases for my Didit application through the Management API.

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

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

Goal:
\- Retrieve cases with the same filtering the Console's Cases list offers: status, priority, source, blueprint, assignee, tag, created-date range, due-before, and overdue. Paginated with limit/offset.

Useful query params:
\- status__in=OPEN,AWAITING_USER,RESOLVED (comma-separated)
\- priority=LOW,MEDIUM,HIGH (comma-separated)
\- source__in=MANUAL,AML_SCREENING,TRANSACTION_RULE,WORKFLOW_BUILDER
\- blueprint=<uuid>, assigned_to=<uuid>, unassigned=true|false, tag=<string>
\- search=<string> - matches title, case_number, tag, subject name/UUID/external ID, linked session UUID, linked transaction UUID
\- date_from=YYYY-MM-DD, date_to=YYYY-MM-DD (created_at range), due_before=<ISO datetime>, overdue=true
\- ordering=created_at|-created_at|due_at|-due_at (default -created_at)

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/?status__in=OPEN,AWAITING_USER&ordering=-due_at" \
-H "x-api-key: YOUR_API_KEY"

Response shape:
\{"count": int, "next": url|null, "previous": url|null, "results": [CaseListItem, ...]}
count is exact up to 100 and capped at 100 beyond that for performance - rely on next being null to detect the last page, never on count.
Each CaseListItem has uuid, case_number, title, status, resolution, pending_resolution (set only while a 4-eyes resolution is staged), checker {member_uuid, name, email}, priority, source, tags, subject {type, uuid, name, external_id, country, portrait}, assigned_to {uuid, full_name, email}, team {uuid, name}, blueprint {uuid, name}, links_count, notes_count, due_at, resolved_at, created_at, updated_at.
\- subject.country - ISO 3166-1 alpha-3 code, or null when unknown. A business: its country of incorporation. A person: the issuing country of one of their identity documents.
\- subject.portrait - short-lived signed URL of the person's portrait, or null. Always null for a business. Download the image when you read it; do not store the URL.
\- team - the review team that owns the case, or null.
\- checker - the member named to approve a pending four-eyes resolution, or null. Set only while a resolution waits on a named checker; name is null when unknown.

Failure modes:
\- 401 - missing or malformed x-api-key.
\- 403 - a key with restricted access gets {"detail": "This API key has no access to this endpoint."} (cases need a full-access key). A console member token needs list:cases.

Side effects: none, pure read.

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

\</pre>



      
      

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

एप्लिकेशन के केस सूचीबद्ध करें, डिफ़ॉल्ट रूप से सबसे नए पहले। Console की केस सूची में उपलब्ध हर फ़िल्टर और सॉर्ट विकल्प क्वेरी पैरामीटर के रूप में उपलब्ध है, जिसमें `search` भी शामिल है, जो विषय, टैग, केस नंबर और जुड़े सत्र या लेन-देन ID में पूर्ण-पाठ खोज करता है।
हर केस में उसका मालिक `team`, लंबित फ़ोर-आइज़ समाधान का नामित `checker`, और विषय का `country` व `portrait` भी शामिल होता है।## पहुँचकेस endpoint के लिए पूर्ण-पहुँच वाली [API कुंजी](https://docs.didit.me/hi/console/api-keys.md) आवश्यक है।
सीमित पहुँच वाली कुंजी को `403` मिलता है।## संबंधित- [केस बनाएँ](https://docs.didit.me/hi/management-api/cases/create.md)
- [केस अपडेट करें](https://docs.didit.me/hi/management-api/cases/update.md)
- [केस विश्लेषण](https://docs.didit.me/hi/management-api/cases/statistics.md)
- [केस (Console)](https://docs.didit.me/hi/console/case-management/cases.md)


## OpenAPI

````yaml hi/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/
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/:
    get:
      tags:
        - Cases
      summary: केस सूचीबद्ध करें
      description: >-
        एप्लिकेशन के लिए केस सूचीबद्ध करें, नवीनतम पहले। फ़िल्टरिंग, खोज और
        सॉर्टिंग का समर्थन करता है; क्वेरी पैरामीटर देखें। `limit`/`offset` के
        साथ पेजिनेटेड।
      operationId: list_cases
      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: पेज का आकार। डिफ़ॉल्ट 50 है।
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
          description: पहले रिकॉर्ड का शून्य-आधारित ऑफ़सेट।
        - name: status__in
          in: query
          schema:
            type: string
          description: >-
            शामिल करने के लिए स्थितियों की अल्पविराम से अलग की गई सूची, उदाहरण
            के लिए OPEN,AWAITING_USER।
        - name: priority
          in: query
          schema:
            type: string
          description: शामिल करने के लिए प्राथमिकताओं की अल्पविराम से अलग की गई सूची।
        - name: source__in
          in: query
          schema:
            type: string
          description: शामिल करने के लिए स्रोतों की अल्पविराम से अलग की गई सूची।
        - name: blueprint
          in: query
          schema:
            type: string
            format: uuid
          description: इस ब्लूप्रिंट वाले केसों को फ़िल्टर करें।
        - name: assigned_to
          in: query
          schema:
            type: string
            format: uuid
          description: इस उपयोगकर्ता को असाइन किए गए केसों को फ़िल्टर करें।
        - name: unassigned
          in: query
          schema:
            type: boolean
          description: असाइन नहीं किए गए केस के लिए true, असाइन किए गए केस के लिए false।
        - name: tag
          in: query
          schema:
            type: string
          description: इस सटीक टैग वाले केसों को फ़िल्टर करें।
        - name: search
          in: query
          schema:
            type: string
          description: >-
            title, case_number, tag, विषय नाम/UUID/external ID, लिंक किए गए सत्र
            UUID, या लिंक किए गए लेन-देन UUID से मेल खाता है।
        - name: date_from
          in: query
          schema:
            type: string
            format: date
          description: निर्माण-समय की निचली सीमा (समावेशी)।
        - name: date_to
          in: query
          schema:
            type: string
            format: date
          description: निर्माण-समय की ऊपरी सीमा (समावेशी)।
        - name: due_before
          in: query
          schema:
            type: string
            format: date-time
          description: due_at ऊपरी सीमा।
        - name: overdue
          in: query
          schema:
            type: boolean
          description: केवल अतिदेय open/awaiting-user केस वापस करने के लिए true।
        - name: ordering
          in: query
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
              - due_at
              - '-due_at'
            default: '-created_at'
          description: सॉर्ट क्रम। due_at में nulls को अंत में सॉर्ट किया जाता है।
      responses:
        '200':
          description: पेजिनेटेड केस सूची।
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: >-
                      मेल खाने वाली पंक्तियों की संख्या। 100 तक सटीक,
                      परफ़ॉर्मेंस के लिए उससे अधिक होने पर 100 पर सीमित। अंतिम
                      पेज का पता लगाने के लिए `next` के null होने पर निर्भर
                      रहें।
                  next:
                    type: string
                    nullable: true
                    description: अगले पेज का पूर्ण URL, या null।
                  previous:
                    type: string
                    nullable: true
                    description: पिछले पेज का पूर्ण URL, या null।
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/CaseListItem'
      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/?status__in=OPEN,AWAITING_USER&ordering=-due_at'
            \
              -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.cases.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.cases.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.Cases.ListAutoPaging(ctx, didit.CasesListParams{})\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.cases().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->cases->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.cases.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.Cases.ListAsync())
            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    CaseListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        case_number:
          type: string
          nullable: true
          description: स्वतः-असाइन किया गया, उदा. CS-0001।
        title:
          type: string
        status:
          type: string
          enum:
            - OPEN
            - AWAITING_USER
            - RESOLVED
        resolution:
          type: string
          enum:
            - FALSE_POSITIVE
            - VALID_THREAT
            - INCONCLUSIVE
            - REQUIREMENTS_NOT_MET
            - REQUIREMENTS_SATISFIED
          nullable: true
        pending_resolution:
          type: object
          nullable: true
          description: >-
            केवल तभी सेट होता है जब चेकर ब्लूप्रिंट पर 4-eyes समाधान स्टेज किया
            गया हो और वह approve या reject-approval की प्रतीक्षा कर रहा हो।
          properties:
            resolution:
              type: string
              enum:
                - FALSE_POSITIVE
                - VALID_THREAT
                - INCONCLUSIVE
                - REQUIREMENTS_NOT_MET
                - REQUIREMENTS_SATISFIED
            resolution_notes:
              type: string
              nullable: true
            maker_email:
              type: string
              format: email
              nullable: true
              description: >-
                रिज़ॉल्यूशन सबमिट करने वाले अधिकारी का ईमेल। API कुंजी द्वारा
                सबमिट किए जाने पर Null: उस रिज़ॉल्यूशन का कोई रिकॉर्डेड निर्माता
                नहीं होता है, इसलिए approve और reject-approval प्रत्येक कॉलर के
                लिए 403 लौटाते हैं।
            maker_name:
              type: string
              nullable: true
            maker_user_id:
              type: string
              format: uuid
              nullable: true
              description: >-
                रिज़ॉल्यूशन सबमिट करने वाले अधिकारी का सदस्य उपयोगकर्ता uuid।
                API कुंजी द्वारा सबमिट किए जाने पर null। उस सदस्य को `checker`
                के रूप में नामित नहीं किया जा सकता है।
            maker_blueprint_id:
              type: string
              format: uuid
            staged_at:
              type: string
              format: date-time
        checker:
          $ref: '#/components/schemas/CaseChecker'
        priority:
          type: string
          enum:
            - LOW
            - MEDIUM
            - HIGH
        source:
          type: string
          enum:
            - MANUAL
            - AML_SCREENING
            - TRANSACTION_RULE
            - WORKFLOW_BUILDER
        tags:
          type: array
          items:
            type: string
        subject:
          $ref: '#/components/schemas/CaseSubject'
        assigned_to:
          $ref: '#/components/schemas/CaseAssignee'
        assigned_at:
          type: string
          format: date-time
          nullable: true
        team:
          $ref: '#/components/schemas/CaseTeamSummary'
        due_at:
          type: string
          format: date-time
          nullable: true
        resolved_at:
          type: string
          format: date-time
          nullable: true
        created_by_email:
          type: string
          nullable: true
        created_by_name:
          type: string
          nullable: true
        blueprint:
          $ref: '#/components/schemas/CaseBlueprintSummary'
        links_count:
          type: integer
        notes_count:
          type: integer
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        application_id:
          type: string
          format: uuid
        application_name:
          type: string
        organization_id:
          type: string
          format: uuid
        organization_name:
          type: string
    CaseChecker:
      type: object
      nullable: true
      description: >-
        लंबित समाधान को स्वीकृत या अस्वीकृत करने के लिए नामित सदस्य। केवल तभी
        सेट किया जाता है जब फ़ोर-आईज़ समाधान किसी नामित चेकर की प्रतीक्षा कर रहा
        हो। कुछ भी लंबित न होने पर, लंबित समाधान के चेकर कतार में प्रतीक्षा करने
        के दौरान, और साक्ष्य बदलने के कारण समाधान स्वीकृत, अस्वीकृत, या नई
        समीक्षा के लिए वापस किए जाने के बाद Null।
      properties:
        member_uuid:
          type: string
          format: uuid
          description: >-
            सदस्य का उपयोगकर्ता uuid: वह मान जो आप केस हल करते समय `checker` के
            रूप में पास करते हैं।
        name:
          type: string
          nullable: true
          description: सदस्य का पूरा नाम, या ज्ञात न होने पर null।
        email:
          type: string
          format: email
    CaseSubject:
      type: object
      nullable: true
      description: एकल उपयोगकर्ता या व्यवसाय जिससे केस जुड़ा हुआ है।
      properties:
        type:
          type: string
          enum:
            - user
            - business
        uuid:
          type: string
          format: uuid
        name:
          type: string
        external_id:
          type: string
          nullable: true
          description: सब्जेक्ट का vendor_data।
        country:
          type: string
          nullable: true
          description: >-
            विषय का तीन-अक्षरों वाला देश कोड (ISO 3166-1 alpha-3), या ज्ञात न
            होने पर null। किसी व्यवसाय के लिए, उसके निगमन का देश। किसी व्यक्ति
            के लिए, उनके सत्यापनों से पहचान दस्तावेज़ का जारीकर्ता देश; कई देशों
            के दस्तावेज़ों वाला व्यक्ति उनमें से एक दिखाता है, और ICAO दस्तावेज़
            कोड जैसे कि `XXA` दिखाई दे सकते हैं।
          example: ESP
        portrait:
          type: string
          format: uri
          nullable: true
          description: >-
            व्यक्ति की पोर्ट्रेट छवि का अल्पकालिक हस्ताक्षरित URL। व्यवसाय के
            लिए हमेशा null, और बिना पोर्ट्रेट वाले व्यक्ति के लिए null। URL की
            समय-सीमा समाप्त हो जाती है, इसलिए URL संग्रहीत करने के बजाय केस
            पढ़ते समय छवि डाउनलोड करें।
    CaseAssignee:
      type: object
      nullable: true
      properties:
        uuid:
          type: string
          format: uuid
        full_name:
          type: string
        email:
          type: string
          format: email
    CaseTeamSummary:
      type: object
      nullable: true
      description: >-
        समीक्षा टीम जो केस का स्वामित्व रखती है, या कोई टीम इसका स्वामित्व न
        रखने पर null। जब कोई रूटिंग नियम केस को उसकी किसी एक टीम को सौंपता है,
        तो रूटिंग इसे सेट करती है। इसे `PATCH .../cases/{case_uuid}/` (`team`)
        के साथ बदलें या साफ़ करें।
      properties:
        uuid:
          type: string
          format: uuid
        name:
          type: string
    CaseBlueprintSummary:
      type: object
      nullable: true
      properties:
        uuid:
          type: string
          format: uuid
        name:
          type: string
          maxLength: 24
  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.