> ## 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 para obtener un caso > Recupera el detalle completo de un caso en Didit: sujeto, blueprint, notas, eventos, enlaces y estado de la lista de verificación. Prompt de la API para obtener un caso Copiar el prompt al portapapeles \

\`Retrieve a single case's full detail through the Management API.

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

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

Path parameter:
\- case_uuid - the case's UUID, from list cases or create case.

Response 200: CaseDetail with uuid, case_number, title, status, resolution, resolution_notes, priority, source, tags, subject {type, uuid, name, external_id, country, portrait}, assigned_to, team {uuid, name}, due_at, resolved_at, pending_resolution (set only while a 4-eyes resolution is staged), checker {member_uuid, name, email}, metadata, blueprint (with content_config), notes (newest 50), events (newest 100), links, checklist_items.
\- 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. Change it with PATCH on the same URL (team).
\- checker - the member named to approve the staged resolution, or null. Set only while pending_resolution waits on a named checker; cleared when the resolution is approved, rejected, or returned for a new review. name is null when unknown.
\- pending_resolution.maker_email is null when an API key submitted the resolution. Such a resolution has no recorded maker, so approve and reject-approval return 403 for every caller: submit four-eyes resolutions as a console member.

Failure modes:
\- 404 - case not found in this application (or deleted).
\- 401/403 - auth/permission errors. A key with restricted access gets 403 {"detail": "This API key has no access to this endpoint."} (cases need a full-access key). A console member token needs read:cases.

Side effects: none, pure read.

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

\
Pegar en Obtén un caso con todo lo necesario para mostrar una página de caso completa: el sujeto, la plantilla del caso (incluido su `content_config`), las notas y los eventos más recientes, los enlaces y el estado de la lista de comprobación. El caso también incluye el `team` al que pertenece, el `checker` designado de una resolución pendiente bajo el principio de los cuatro ojos, y el `country` y el `portrait` del sujeto.## AccesoLos endpoints de casos requieren una [clave de API](https://docs.didit.me/es/console/api-keys.md) con acceso completo. Una clave con acceso restringido recibe una respuesta `403`.## Contenido relacionado- [Listar casos](https://docs.didit.me/es/management-api/cases/list.md) - [Actualizar caso](https://docs.didit.me/es/management-api/cases/update.md) - [Listar notas del caso](https://docs.didit.me/es/management-api/cases/list-notes.md) - [Resolver caso](https://docs.didit.me/es/management-api/cases/resolve.md) ## OpenAPI ````yaml es/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/: get: tags: - Cases summary: Obtener un caso description: >- Obtiene un caso con su sujeto, blueprint, notas, eventos, enlaces y lista de verificación. operationId: get_case parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de la organización. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de la aplicación. - name: case_uuid in: path required: true schema: type: string format: uuid example: c1a5e000-0000-4000-8000-000000000001 description: UUID del caso. responses: '200': description: Detalle del caso. content: application/json: schema: $ref: '#/components/schemas/CaseDetail' '404': description: No se encontró el caso (o el recurso anidado) en esta aplicación. content: application/json: schema: type: object properties: detail: type: string 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/c1a5e000-0000-4000-8000-000000000001/' \ -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( "c1a5e000-0000-4000-8000-000000000001", ) 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.retrieve("c1a5e000-0000-4000-8000-000000000001"); 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.Retrieve(ctx, \"c1a5e000-0000-4000-8000-000000000001\")\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().retrieve("c1a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- cases->retrieve('c1a5e000-0000-4000-8000-000000000001'); 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("c1a5e000-0000-4000-8000-000000000001") 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.RetrieveAsync("c1a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseDetail: type: object properties: uuid: type: string format: uuid case_number: type: string nullable: true 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 resolution_notes: type: string nullable: true 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 resolved_by_email: type: string nullable: true pending_resolution: type: object nullable: true description: >- Se establece solo mientras una resolución de doble validación (4-eyes) está preparada en el blueprint del verificador, a la espera de su aprobación o del rechazo de la aprobación. 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: >- Correo electrónico del responsable que envió la resolución. Null cuando la envió una clave de API: esa resolución no tiene un autor registrado, por lo que aprobar y rechazar la aprobación devuelven 403 para cualquier solicitante. maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- UUID de usuario del miembro responsable que envió la resolución. Es null cuando la envió una clave de API. Ese miembro no puede figurar como `checker`. maker_blueprint_id: type: string format: uuid staged_at: type: string format: date-time checker: $ref: '#/components/schemas/CaseChecker' metadata: type: object blueprint: $ref: '#/components/schemas/CaseBlueprintDetail' notes: type: array items: $ref: '#/components/schemas/CaseNote' description: Las 50 notas más recientes. events: type: array items: $ref: '#/components/schemas/CaseEvent' description: Los 100 eventos más recientes. links: type: array items: $ref: '#/components/schemas/CaseLink' links_count: type: integer notes_count: type: integer checklist_items: type: array items: $ref: '#/components/schemas/CaseChecklistItem' created_at: type: string format: date-time updated_at: type: string format: date-time CaseSubject: type: object nullable: true description: El único usuario o empresa al que está vinculado el caso. 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 sujeto. country: type: string nullable: true description: >- Código de país de tres letras del sujeto (ISO 3166-1 alfa-3), o null cuando no se conoce. Para una empresa, su país de constitución. Para una persona, el país emisor de un documento de identidad de sus verificaciones; una persona con documentos de varios países muestra uno de ellos, y pueden aparecer códigos de documento OACI como `XXA`. example: ESP portrait: type: string format: uri nullable: true description: >- URL firmada de corta duración de la imagen del retrato de la persona. Siempre es null para una empresa, y null para una persona sin retrato. La URL caduca, así que descarga la imagen cuando leas el caso en lugar de guardar 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: >- El equipo de revisión responsable del caso, o null si ningún equipo es responsable. El enrutamiento lo establece cuando una regla de enrutamiento asigna el caso a uno de sus equipos. Cámbialo o bórralo con `PATCH .../cases/{case_uuid}/` (`team`). properties: uuid: type: string format: uuid name: type: string CaseChecker: type: object nullable: true description: >- El miembro designado para aprobar o rechazar la resolución pendiente. Solo tiene valor mientras una resolución con principio de cuatro ojos espera a un verificador designado. Null cuando no hay nada pendiente, mientras la resolución pendiente espera en la cola de verificadores, y una vez que la resolución se aprueba, se rechaza o se devuelve para una nueva revisión porque las pruebas cambiaron. properties: member_uuid: type: string format: uuid description: >- El uuid de usuario del miembro: el valor que pasas como `checker` cuando resuelves el caso. name: type: string nullable: true description: El nombre completo del miembro, o null si no se conoce. email: type: string format: email CaseBlueprintDetail: type: object properties: uuid: type: string format: uuid name: type: string maxLength: 24 description: type: string nullable: true assignment_method: type: string enum: - MANUAL - AUTOMATIC assignee_pool: type: array items: type: string format: uuid max_active_cases: type: integer nullable: true escalation_enabled: type: boolean transfer_enabled: type: boolean require_resolution_note: type: boolean is_active: type: boolean preset_key: type: string nullable: true created_at: type: string format: date-time escalation_blueprint: type: string format: uuid nullable: true escalation_blueprint_name: type: string nullable: true four_eyes_checker_blueprint: type: string format: uuid nullable: true four_eyes_checker_blueprint_name: type: string nullable: true content_config: type: object description: >- Las seis secciones activables que determinan qué pestañas y campos aparecen en la página del caso. Se rechazan las secciones o claves desconocidas. properties: checklist: type: object properties: enabled: type: boolean optional: type: boolean description: >- Si es true, un caso puede resolverse con elementos de la lista de comprobación incompletos. items: type: array items: type: object properties: label: type: string maxLength: 255 order: type: integer aml_control: type: object properties: enabled: type: boolean financial: type: boolean identity: type: boolean identity: type: object properties: enabled: type: boolean personal_information: type: boolean applicant_tags: type: boolean contact_information: type: boolean risk_overview: type: boolean poi_documents: type: boolean poa_documents: type: boolean verifications: type: object properties: enabled: type: boolean summary: type: boolean reporting: type: object properties: enabled: type: boolean fiu_reports: type: boolean financial: type: object properties: enabled: type: boolean payment_methods: type: boolean transactions: type: boolean creation_sources: type: array description: Conectores que actualmente dirigen casos nuevos a este blueprint. items: type: object properties: kind: type: string enum: - aml - rule - workflow id: type: string name: type: string receives_escalation_from: type: array description: Otros blueprints cuyo destino de escalado apunta a este. items: type: object properties: id: type: string name: type: string updated_at: type: string format: date-time version: type: integer readOnly: true default_deadline_hours: type: integer nullable: true minimum: 1 maximum: 8760 CaseNote: type: object properties: uuid: type: string format: uuid comment: type: string actor_email: type: string format: email nullable: true actor_name: type: string nullable: true mentioned_emails: type: array items: type: string format: email is_internal: type: boolean attachments: type: array items: type: object properties: s3_key: type: string filename: type: string file_size: type: integer url: type: string format: uri tags: type: array items: type: string created_at: type: string format: date-time CaseEvent: type: object properties: uuid: type: string format: uuid event_type: type: string enum: - CREATED - STATUS_CHANGED - ASSIGNED - UNASSIGNED - RESOLVED - REOPENED - LINK_ADDED - LINK_REMOVED - NOTE_ADDED - NOTE_PINNED - NOTE_UNPINNED - PRIORITY_CHANGED - DUE_DATE_CHANGED - TAG_ADDED - TAG_REMOVED - ESCALATED - TRANSFERRED - CHECKLIST_COMPLETED - REPORT_CREATED - REPORT_FINALIZED - SUBMITTED_FOR_APPROVAL - APPROVAL_GRANTED - APPROVAL_REJECTED - ENTITY_ACTION - APPROVAL_INVALIDATED - CUSTOMER_REQUEST - STAGE_CHANGED - TEAM_CHANGED - CHECKER_ASSIGNED - CHECKER_UNASSIGNED actor_email: type: string format: email nullable: true actor_name: type: string nullable: true previous_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true new_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true metadata: type: object created_at: type: string format: date-time CaseLink: type: object properties: uuid: type: string format: uuid linked_entity_type: type: string enum: - session - business_session - transaction nullable: true linked_entity_uuid: type: string format: uuid nullable: true linked_entity_summary: type: object nullable: true description: >- session_id/session_number/status para enlaces de session y business_session; uuid/txn_id/status para enlaces de transacción. created_at: type: string format: date-time CaseChecklistItem: type: object properties: uuid: type: string format: uuid label: type: string maxLength: 255 is_completed: type: boolean completed_by: type: string format: email nullable: true completed_at: type: string format: date-time nullable: true order: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.