> ## 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 devolución > Se obtiene una devolución de MED 2.0 por su ID de recurso (UUID), dentro del alcance de la organización del tenant autenticado. La respuesta incluye los campos de liquidación de la fase 2, que son null hasta la liquidación. Devuelve 404 cuando ninguna devolución activa con ese ID pertenece al tenant. Una devolución perteneciente a otro tenant produce la misma respuesta que un ID desconocido. ## OpenAPI ````yaml es/openapi/v3-current/pix-lerian-dict.yaml GET /dict/refunds/{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: /dict/refunds/{id}: get: tags: - Refunds summary: Obtener una devolución description: >- Se obtiene una devolución de MED 2.0 por su ID de recurso (UUID), dentro del alcance de la organización del tenant autenticado. La respuesta incluye los campos de liquidación de la fase 2, que son null hasta la liquidación. Devuelve 404 cuando ninguna devolución activa con ese ID pertenece al tenant. Una devolución perteneciente a otro tenant produce la misma respuesta que un ID desconocido. operationId: getRefund parameters: - description: Refund internal ID (UUID format) in: path name: id required: true schema: description: Refund internal ID (UUID format) examples: - 018f8c1d-1234-7abc-9def-000000000001 type: string example: 01960718-a213-2435-6078-901234567123 responses: '200': content: application/json: schema: $ref: '#/components/schemas/RefundView' examples: ejemploFicticio: summary: Ejemplo ficticio value: alreadySettledAmount: '100.50' analysisDetails: analysisdetails-example analysisResult: TOTALLY_ACCEPTED bacenRefundId: 3d48532f-1a2b-4422-81c3-b7dc852e262b contestedParticipant: '87654321' correlationId: 9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f creationTime: '2026-01-01T12:00:00Z' effectiveRefundedAmount: '100.50' fundsRecoveryId: 019606a1-3b4c-7d8e-9f01-234567890abc id: 018f8c1d-1234-7abc-9def-000000000001 infractionReportId: 019606a1-3b4c-7d8e-9f01-234567890abc lastModified: '2026-01-01T12:30:00Z' monitorAccount: false refundAccount: accountNumber: '123456' accountType: CACC branch: '0001' participant: '99999011' taxIdNumber: '12345678909' refundAmount: '1000.00' refundDetails: refund due to operational failure refundReason: OPERATIONAL_FLAW refundRejectionReason: NO_BALANCE refundTransactionId: 019606a1-3b4c-7d8e-9f01-234567890abc requestingParticipant: '12345678' settleReason: settlereason-example settleType: REFUND status: OPEN surplusAmount: '100.50' transactionId: E12345678202601011200abcdef01234 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/dict/refunds/01960718-a213-2435-6078-901234567123 \ --header 'Authorization: Bearer demo-access-token' components: schemas: RefundView: additionalProperties: false properties: alreadySettledAmount: type: string analysisDetails: type: string analysisResult: enum: - TOTALLY_ACCEPTED - PARTIALLY_ACCEPTED - REJECTED type: string bacenRefundId: examples: - 3d48532f-1a2b-4422-81c3-b7dc852e262b type: string contestedParticipant: examples: - '87654321' type: string correlationId: examples: - 9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f type: string creationTime: examples: - '2026-01-01T12:00:00Z' format: date-time type: string effectiveRefundedAmount: type: string fundsRecoveryId: type: string id: examples: - 018f8c1d-1234-7abc-9def-000000000001 type: string infractionReportId: type: string lastModified: examples: - '2026-01-01T12:30:00Z' format: date-time type: string monitorAccount: examples: - false type: boolean refundAccount: $ref: '#/components/schemas/RefundAccountView' refundAmount: examples: - '1000.00' type: string refundDetails: examples: - refund due to operational failure type: string refundReason: enum: - FRAUD - OPERATIONAL_FLAW - PIX_AUTOMATICO - REFUND_CANCELLED examples: - OPERATIONAL_FLAW type: string refundRejectionReason: enum: - NO_BALANCE - ACCOUNT_CLOSURE - INVALID_REQUEST - OTHER - PARTICIPANT_EXCLUSION type: string refundTransactionId: type: string requestingParticipant: examples: - '12345678' type: string settleReason: type: string settleType: enum: - REFUND - MANUAL type: string status: enum: - OPEN - CLOSED - CANCELLED examples: - OPEN type: string surplusAmount: type: string transactionId: examples: - E12345678202601011200abcdef01234 type: string required: - id - transactionId - refundReason - refundAmount - status - requestingParticipant - contestedParticipant - monitorAccount - creationTime - lastModified 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 RefundAccountView: additionalProperties: false properties: accountNumber: examples: - '123456' type: string accountType: examples: - CACC type: string branch: examples: - '0001' type: string participant: examples: - '99999011' type: string taxIdNumber: examples: - '12345678909' type: string required: - taxIdNumber - participant - branch - accountNumber - accountType 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 securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````