> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Obtener una reclamación de clave Pix > Se obtiene una reclamación Pix por su identificador, incluido events[] en orden ascendente de createdAt. La reclamación debe pertenecer a la cuenta identificada por X-Account-Id. Una reclamación fuera de ese alcance devuelve la misma respuesta de recurso no encontrado que una reclamación desconocida. ## OpenAPI ````yaml es/openapi/v3-current/pix-lerian-dict.yaml GET /claims/{claim_id} openapi: 3.1.0 info: contact: name: Lerian Studio url: https://lerian.studio description: >- API pública para claves Pix, reclamos, marcadores de fraude, reportes de infracción y recuperación de fondos del MED. license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license title: Pix Lerian — DICT version: release-candidate servers: - url: https://api.example.com/dict-hub/v1 description: >- El host de ejemplo debe reemplazarse por la URL proporcionada durante el onboarding del entorno. security: - BearerAuth: [] tags: - description: Registro, consulta, listado, actualización y eliminación de claves Pix. name: Entries - description: >- Consulta de claves Pix y verificación de su existencia en el directorio DICT. name: Keys - description: Gestión de reclamaciones de titularidad y portabilidad de claves Pix. name: Claims - description: Gestión de recuperaciones de fondos de MED 2.0 asociadas al participante. name: Funds Recoveries - description: >- Gestión de reportes de infracción de MED 2.0 para la organización autenticada. name: Infraction Reports - description: Creación, consulta, cancelación y liquidación de devoluciones de MED 2.0. name: Refunds - description: Creación, consulta, listado y cancelación de marcadores de fraude de DICT. name: Fraud Markers paths: /claims/{claim_id}: get: tags: - Claims summary: Obtener una reclamación de clave Pix description: >- Se obtiene una reclamación Pix por su identificador, incluido events[] en orden ascendente de createdAt. La reclamación debe pertenecer a la cuenta identificada por X-Account-Id. Una reclamación fuera de ese alcance devuelve la misma respuesta de recurso no encontrado que una reclamación desconocida. operationId: getClaim parameters: - description: Claim ID (UUID format) in: path name: claim_id required: true schema: description: Claim ID (UUID format) examples: - 019606c3-5d6e-7f80-1b23-456789012cde type: string example: 019606c3-5d6e-7f80-1b23-456789012cde - description: UUID de la cuenta asociada a la operación. in: header name: X-Account-Id required: true schema: description: UUID de la cuenta asociada a la operación. examples: - 019606a1-3b4c-7d8e-9f01-234567890abc type: string example: 019606a1-3b4c-7d8e-9f01-234567890abc responses: '200': content: application/json: schema: $ref: '#/components/schemas/GetClaimOutput' examples: ejemploFicticio: summary: Ejemplo ficticio value: accountId: 019606a1-3b4c-7d8e-9f01-234567890abc bacenId: claim-bacen-001 cancelReason: cancelreason-example cancelledBy: cancelledby-example claimId: 019606c3-5d6e-7f80-1b23-456789012cde claimer: account: branch: '0001' number: '1234567' openingDate: '2024-03-10' type: CACC document: '52998224725' name: Maria da Silva participant: '87654321' personType: NATURAL_PERSON tradeName: Silva ME completionPeriodEnd: '2026-06-18T03:00:00Z' confirmReason: confirmreason-example correlationId: a9f13566e19f5ca51329479a5bae60c5 createdAt: '2026-05-19T14:30:00Z' donorParticipant: '12345678' events: - actor: SYSTEM createdAt: '2026-05-19T14:32:11Z' id: 019606c3-5d6e-7f80-1b23-456789012cde previousStatus: OPEN source: ADAPTER_WEBHOOK status: WAITING_RESOLUTION keyType: PHONE keyValue: '+5511987659999' lastModified: '2026-05-19T14:32:11Z' requestId: e7c1a2b3-4d5e-6f70-8a90-1b2c3d4e5f60 resolutionPeriodEnd: '2026-05-25T03:00:00Z' status: WAITING_RESOLUTION type: PORTABILITY updatedAt: '2026-05-19T14:32:11Z' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error x-codeSamples: - lang: bash label: cURL con datos ficticios source: |- curl --request GET \ --url https://api.example.com/dict-hub/v1/claims/019606c3-5d6e-7f80-1b23-456789012cde \ --header 'Authorization: Bearer demo-access-token' \ --header 'X-Account-Id: 019606a1-3b4c-7d8e-9f01-234567890abc' components: schemas: GetClaimOutput: additionalProperties: false properties: accountId: examples: - 019606a1-3b4c-7d8e-9f01-234567890abc type: string bacenId: examples: - claim-bacen-001 type: string cancelReason: type: string cancelledBy: type: string claimId: examples: - 019606c3-5d6e-7f80-1b23-456789012cde type: string claimer: $ref: '#/components/schemas/ClaimClaimerOutput' completionPeriodEnd: examples: - '2026-06-18T03:00:00Z' type: string confirmReason: type: string correlationId: examples: - a9f13566e19f5ca51329479a5bae60c5 type: string createdAt: examples: - '2026-05-19T14:30:00Z' type: string donorParticipant: examples: - '12345678' type: string events: items: $ref: '#/components/schemas/ClaimEventOutput' type: - array - 'null' keyType: examples: - PHONE type: string keyValue: examples: - '+5511987659999' type: string lastModified: examples: - '2026-05-19T14:32:11Z' type: string requestId: examples: - e7c1a2b3-4d5e-6f70-8a90-1b2c3d4e5f60 type: string resolutionPeriodEnd: examples: - '2026-05-25T03:00:00Z' type: string status: examples: - WAITING_RESOLUTION type: string type: examples: - PORTABILITY type: string updatedAt: examples: - '2026-05-19T14:32:11Z' type: string required: - events - claimId - accountId - bacenId - status - type - keyType - keyValue - donorParticipant - claimer - lastModified - createdAt - updatedAt type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object ClaimClaimerOutput: additionalProperties: false properties: account: $ref: '#/components/schemas/ClaimClaimerAccountOutput' document: examples: - '52998224725' type: string name: examples: - Maria da Silva type: string participant: examples: - '87654321' type: string personType: examples: - NATURAL_PERSON type: string tradeName: examples: - Silva ME type: string required: - participant type: object ClaimEventOutput: additionalProperties: false properties: actor: examples: - SYSTEM type: string createdAt: examples: - '2026-05-19T14:32:11Z' type: string id: examples: - 019606c3-5d6e-7f80-1b23-456789012cde type: string previousStatus: examples: - OPEN type: - string - 'null' source: examples: - ADAPTER_WEBHOOK type: string status: examples: - WAITING_RESOLUTION type: string required: - id - status - previousStatus - actor - source - createdAt type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object ClaimClaimerAccountOutput: additionalProperties: false properties: branch: examples: - '0001' type: string number: examples: - '1234567' type: string openingDate: examples: - '2024-03-10' type: string type: examples: - CACC type: string required: - branch - number - type - openingDate type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````