> ## 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 per llistar casos > Llista casos de compliment de Didit per estat, prioritat, origen, plantilla, responsable, etiqueta i data límit, amb cerca de text complet. Indicació de l'API per llistar casos Copia el prompt al porta-retalls \

\`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.`

\
Enganxa a Llista els casos de l'aplicació, del més recent al més antic per defecte. Cada filtre i opció d'ordenació disponible a la llista de casos de la Console s'exposa com a paràmetre de consulta, inclosa la cerca de text complet `search` en l'assumpte, les etiquetes, el número de cas i els identificadors de sessió o transacció enllaçats. Cada cas també inclou el seu `team` propietari, el `checker` designat d'una resolució pendent segons el principi dels quatre ulls, i el `country` i el `portrait` del subjecte.## AccésEls endpoints dels casos requereixen una [clau d'API](https://docs.didit.me/ca/console/api-keys.md) amb accés complet. Una clau amb accés restringit rep `403`.## Relacionats- [Crear un cas](https://docs.didit.me/ca/management-api/cases/create.md) - [Actualitzar el cas](https://docs.didit.me/ca/management-api/cases/update.md) - [Anàlisi de casos](https://docs.didit.me/ca/management-api/cases/statistics.md) - [Casos (Console)](https://docs.didit.me/ca/console/case-management/cases.md) ## OpenAPI ````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/: get: tags: - Cases summary: Llista els casos description: >- Llista els casos de l'aplicació, els més recents primer. Admet filtres, cerca i ordenació; consulta els paràmetres de consulta. Paginat amb `limit`/`offset`. operationId: list_cases parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organització. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de l'aplicació. - name: limit in: query schema: type: integer default: 50 minimum: 1 description: Mida de la pàgina. Per defecte és 50. - name: offset in: query schema: type: integer default: 0 minimum: 0 description: Desplaçament basat en zero del primer registre. - name: status__in in: query schema: type: string description: >- Estats separats per comes que cal incloure, p. ex. OPEN,AWAITING_USER. - name: priority in: query schema: type: string description: Prioritats separades per comes que cal incloure. - name: source__in in: query schema: type: string description: Fonts separades per comes que cal incloure. - name: blueprint in: query schema: type: string format: uuid description: Filtra pels casos d'aquest blueprint. - name: assigned_to in: query schema: type: string format: uuid description: Filtra pels casos assignats a aquest usuari. - name: unassigned in: query schema: type: boolean description: true per a casos no assignats, false per a casos assignats. - name: tag in: query schema: type: string description: Filtra pels casos que tinguin exactament aquesta etiqueta. - name: search in: query schema: type: string description: >- Coincideix amb title, case_number, tag, nom/UUID/ID extern del subjecte, UUID de la sessió enllaçada o UUID de la transacció enllaçada. - name: date_from in: query schema: type: string format: date description: Límit inferior de la data de creació (inclusiu). - name: date_to in: query schema: type: string format: date description: Límit superior de la data de creació (inclusiu). - name: due_before in: query schema: type: string format: date-time description: Límit superior de due_at. - name: overdue in: query schema: type: boolean description: >- true per retornar només els casos vençuts en estat obert o en espera de l'usuari. - name: ordering in: query schema: type: string enum: - created_at - '-created_at' - due_at - '-due_at' default: '-created_at' description: Criteri d'ordenació. due_at situa els valors nuls al final. responses: '200': description: Llista paginada de casos. content: application/json: schema: type: object properties: count: type: integer description: >- Nombre de files coincidents. Exacte fins a 100, limitat a 100 a partir d'aquí per motius de rendiment. Fes servir el fet que `next` sigui null per detectar l'última pàgina. next: type: string nullable: true description: URL absoluta de la pàgina següent, o null. previous: type: string nullable: true description: URL absoluta de la pàgina anterior, o 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: Assignat automàticament, p. ex. 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: >- S'estableix només mentre una resolució de 4 ulls està preparada a l'esquema del verificador, esperant l'aprovació o el rebuig de l'aprovació. 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: >- Correu electrònic del responsable que ha enviat la resolució. Null quan l'ha enviat una clau d'API: aquesta resolució no té cap autor registrat, de manera que approve i reject-approval retornen 403 per a qualsevol persona que els cridi. maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- UUID d'usuari membre del responsable que ha enviat la resolució. Null quan l'ha enviada una clau d'API. Aquest membre no es pot indicar com a `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: >- El membre designat per aprovar o rebutjar la resolució pendent. Només s'estableix mentre una resolució de quatre ulls espera un revisor designat. Null quan no hi ha res pendent, mentre la resolució pendent espera a la cua de revisors i un cop la resolució ha estat aprovada, rebutjada o retornada per a una nova revisió perquè les proves han canviat. properties: member_uuid: type: string format: uuid description: >- L'uuid d'usuari del membre: el valor que passes com a `checker` quan resols el cas. name: type: string nullable: true description: El nom complet del membre, o null quan no es coneix. email: type: string format: email CaseSubject: type: object nullable: true description: L'únic usuari o empresa al qual està vinculat el cas. properties: type: type: string enum: - user - business uuid: type: string format: uuid name: type: string external_id: type: string nullable: true description: El vendor_data del subjecte. country: type: string nullable: true description: >- Codi de país de tres lletres del subjecte (ISO 3166-1 alfa-3), o null quan no es coneix. Per a una empresa, el seu país de constitució. Per a una persona, el país emissor d'un document d'identitat de les seves verificacions; una persona amb documents de diversos països en mostra un d'ells, i poden aparèixer codis de document de l'OACI com ara `XXA`. example: ESP portrait: type: string format: uri nullable: true description: >- URL signada de curta durada de la imatge de retrat de la persona. Sempre null per a una empresa, i null per a una persona sense retrat. La URL caduca, així que descarrega la imatge quan llegeixis el cas en lloc d'emmagatzemar la 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: >- L'equip de revisió propietari del cas, o null quan cap equip n'és el propietari. L'encaminament l'assigna quan una regla d'encaminament assigna el cas a un dels seus equips. Canvia'l o buida'l amb `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: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.