> ## 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. # Fallmanagement-API: Fälle auflisten > Compliance-Fälle nach Status, Priorität, Quelle, Blueprint, Bearbeiter, Tag und Fälligkeitsdatum auflisten, mit Volltextsuche. Mit der Didit Management API. Prompt: Fälle der API auflisten Prompt in die Zwischenablage kopieren \

\`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=, assigned_to=, unassigned=true|false, tag=
\- search= - 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=, 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.`

\
Einfügen in Listet die Fälle der Anwendung auf, standardmäßig die neuesten zuerst. Für jede Filter- und Sortieroption, die in der Fälleliste der Console verfügbar ist, gibt es einen Abfrageparameter. Dazu gehört die Volltextsuche über `search`, die Betreff, Tags, Fallnummer sowie verknüpfte Sitzungs- und Transaktions-IDs durchsucht. Jeder Fall enthält außerdem das zuständige `team`, den benannten `checker` einer ausstehenden Vier-Augen-Entscheidung sowie das `country` und das `portrait` der betroffenen Person.## ZugriffFür die Fall-Endpoints benötigen Sie einen [API-Schlüssel](https://docs.didit.me/de/console/api-keys.md) mit Vollzugriff. Ein Schlüssel mit eingeschränktem Zugriff erhält `403`.## Verwandte Themen- [Fall erstellen](https://docs.didit.me/de/management-api/cases/create.md) - [Fall aktualisieren](https://docs.didit.me/de/management-api/cases/update.md) - [Fall-Analysen](https://docs.didit.me/de/management-api/cases/statistics.md) - [Fälle (Console)](https://docs.didit.me/de/console/case-management/cases.md) ## OpenAPI ````yaml de/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 für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/: get: tags: - Cases summary: Fälle auflisten description: >- Fälle für die Anwendung auflisten, neueste zuerst. Unterstützt Filterung, Suche und Sortierung; siehe Abfrageparameter. Paginiert mit `limit`/`offset`. operationId: list_cases parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID der Organisation. - name: application_id in: path required: true schema: type: string format: uuid description: Anwendungs-UUID. - name: limit in: query schema: type: integer default: 50 minimum: 1 description: Seitengröße. Standardmäßig 50. - name: offset in: query schema: type: integer default: 0 minimum: 0 description: Nullbasierter Offset des ersten Datensatzes. - name: status__in in: query schema: type: string description: >- Kommagetrennte Liste der einzuschließenden Status, z. B. OPEN,AWAITING_USER. - name: priority in: query schema: type: string description: Kommagetrennte Liste der einzuschließenden Prioritäten. - name: source__in in: query schema: type: string description: Kommagetrennte Liste der einzuschließenden Quellen. - name: blueprint in: query schema: type: string format: uuid description: Auf Fälle mit diesem Blueprint filtern. - name: assigned_to in: query schema: type: string format: uuid description: Auf Fälle filtern, die diesem Benutzer zugewiesen sind. - name: unassigned in: query schema: type: boolean description: true für nicht zugewiesene Fälle, false für zugewiesene Fälle. - name: tag in: query schema: type: string description: Auf Fälle filtern, die genau diesen Tag aufweisen. - name: search in: query schema: type: string description: >- Stimmt mit title, case_number, tag, dem Namen, der UUID oder der externen ID der betroffenen Person sowie der verknüpften Sitzungs-UUID oder Transaktions-UUID überein. - name: date_from in: query schema: type: string format: date description: Untergrenze für das Erstellungsdatum (inklusiv). - name: date_to in: query schema: type: string format: date description: Obergrenze für das Erstellungsdatum (inklusiv). - name: due_before in: query schema: type: string format: date-time description: due_at Obergrenze. - name: overdue in: query schema: type: boolean description: >- true, um nur überfällige Fälle im Status open/awaiting-user zurückzugeben. - name: ordering in: query schema: type: string enum: - created_at - '-created_at' - due_at - '-due_at' default: '-created_at' description: Sortierreihenfolge. due_at sortiert Nullwerte zuletzt. responses: '200': description: Paginierte Fallliste. content: application/json: schema: type: object properties: count: type: integer description: >- Anzahl der übereinstimmenden Zeilen. Exakt bis 100, darüber aus Performancegründen auf 100 begrenzt. Verlassen Sie sich darauf, dass `next` null ist, um die letzte Seite zu erkennen. next: type: string nullable: true description: Absolute URL der nächsten Seite oder null. previous: type: string nullable: true description: Absolute URL der vorherigen Seite oder 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: |- 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: Automatisch zugewiesen, z. B. 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: >- Wird nur gesetzt, während eine 4-Augen-Auflösung auf der Checker-Vorlage bereitgestellt ist und auf Genehmigung oder Ablehnung der Genehmigung wartet. 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: >- E-Mail des Beauftragten, der den Beschluss eingereicht hat. Null, wenn er über einen API-Schlüssel eingereicht wurde: Dieser Beschluss hat keinen erfassten Ersteller, sodass approve und reject-approval für jeden Aufrufer 403 zurückgeben. maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- Benutzer-UUID des Mitglieds, das als Beauftragter die Entscheidung eingereicht hat. Null, wenn sie über einen API-Schlüssel eingereicht wurde. Dieses Mitglied kann nicht als `checker` benannt werden. 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: >- Das benannte Mitglied zur Genehmigung oder Ablehnung des ausstehenden Beschlusses. Nur gesetzt, während ein Vier-Augen-Beschluss auf einen benannten Prüfer wartet. Null, wenn nichts aussteht, während der ausstehende Beschluss in der Prüfer-Warteschlange wartet und sobald der Beschluss genehmigt, abgelehnt oder aufgrund geänderter Nachweise zur erneuten Prüfung zurückgegeben wurde. properties: member_uuid: type: string format: uuid description: >- Die Benutzer-UUID des Mitglieds: der Wert, den Sie als `checker` übergeben, wenn Sie den Fall lösen. name: type: string nullable: true description: >- Der vollständige Name des Mitglieds oder null, wenn er nicht bekannt ist. email: type: string format: email CaseSubject: type: object nullable: true description: >- Der einzelne Benutzer oder das Unternehmen, an den bzw. das der Fall gebunden ist. properties: type: type: string enum: - user - business uuid: type: string format: uuid name: type: string external_id: type: string nullable: true description: Die vendor_data des Subjekts. country: type: string nullable: true description: >- Dreistelliger Ländercode des Subjekts (ISO 3166-1 Alpha-3) oder null, wenn unbekannt. Bei einem Unternehmen das Land der Gründung. Bei einer Person das Ausstellungsland eines Ausweisdokuments aus deren Verifizierungen; bei einer Person mit Dokumenten aus mehreren Ländern wird eines davon angezeigt, und es können ICAO-Dokumentencodes wie `XXA` vorkommen. example: ESP portrait: type: string format: uri nullable: true description: >- Kurzlebige signierte URL des Porträtbildes der Person. Für ein Unternehmen immer null und null für eine Person ohne Porträt. Die URL läuft ab, laden Sie das Bild daher beim Lesen des Falls herunter, anstatt die URL zu speichern. 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: >- Das Prüfungsteam, das für den Fall zuständig ist, oder null, wenn kein Team zuständig ist. Das Routing legt dies fest, wenn eine Routing-Regel den Fall einem ihrer Teams zuweist. Ändern oder löschen Sie dies mit `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: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.