> ## 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. # Recuperar una transferencia Pix > Usa este endpoint para recuperar una transferencia Pix por su identificador único. ## OpenAPI ````yaml es/openapi/v3-current/indirect-pix.yaml GET /v1/transfers/{transfer_id} openapi: 3.0.3 info: title: Plugin BR Pix Indirect - API completa description: | API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.7.6 servers: - url: https://plugin-pix-indirect.api.lerian.net security: - bearerAuth: [] paths: /v1/transfers/{transfer_id}: get: tags: - Transactions API summary: Recuperar una transferencia Pix description: >- Usa este endpoint para recuperar una transferencia Pix por su identificador único. parameters: - $ref: '#/components/parameters/TransferId' - $ref: '#/components/parameters/XAccountId' responses: '200': description: Detalles de la transferencia Pix recuperados correctamente. content: application/json: schema: $ref: '#/components/schemas/TransferObject' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0001: $ref: '#/components/examples/ErrorPIX0001' ErrorPIX0008: $ref: '#/components/examples/ErrorPIX0008' ErrorPIX0404: $ref: '#/components/examples/ErrorPIX0404' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0407: $ref: '#/components/examples/ErrorPIX0407' ErrorPIX0426: $ref: '#/components/examples/ErrorPIX0426' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0000: $ref: '#/components/examples/ErrorPIX0000' deprecated: false security: - bearerAuth: [] components: parameters: TransferId: name: transfer_id in: path description: Identificador único de la transferencia Pix (formato UUID). required: true example: 019c96a0-0c21-71f9-a487-66a1258278a1 schema: type: string XAccountId: name: X-Account-Id in: header description: Identificador único de la cuenta del Ledger de Midaz (formato UUID). required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string schemas: TransferObject: type: object properties: id: type: string description: Identificador único de la transferencia. example: 019c96a0-0c21-71f9-a487-66a1258278a1 endToEndId: type: string description: Identificador de extremo a extremo. example: E123456789BR1234567890123456789 amount: type: string description: Monto de la transferencia en BRL (formato `0.00`). example: '100.00' status: type: string description: Estado de la transferencia. enum: - CREATED - PENDING - PROCESSING - COMPLETED - FAILED - REVERSED example: COMPLETED type: type: string description: Tipo de transferencia. enum: - CASHOUT - CASHIN example: CASHOUT description: type: string maxLength: 140 description: Descripción o mensaje opcional. example: Pix Cashout Transfer source: $ref: '#/components/schemas/TransferPartyObject' destination: $ref: '#/components/schemas/TransferPartyObject' paymentType: type: string description: Tipo de pago. enum: - IMMEDIATE - SCHEDULED example: IMMEDIATE initiationType: type: string description: Tipo de iniciación. enum: - MANUAL - KEY - QR_CODE example: KEY urgency: type: string description: Urgencia de la transferencia. enum: - HIGH - NORMAL example: HIGH purpose: type: string description: >- Tipo de finalidad de la transacción. El valor predeterminado es TRANSFER. enum: - TRANSFER - INSTANT_PAYMENT_REFUND example: TRANSFER accountId: type: string description: Identificador de la cuenta (UUID). example: 01989f9e-6508-79f8-9540-835be49fbd0d aliasId: type: string description: Identificador del alias (UUID). example: 01989f9e-6508-79f8-9540-835be49fbd0e initiatedAt: type: string format: date-time description: Marca de tiempo de la iniciación (ISO 8601 UTC). example: '2024-01-15T10:30:00Z' createdAt: type: string format: date-time example: '2024-01-15T10:30:00Z' updatedAt: type: string format: date-time example: '2024-01-15T10:30:00Z' ledger: $ref: '#/components/schemas/LedgerInfoObject' metadata: type: object additionalProperties: true description: >- Atributos personalizados de clave-valor asociados con esta transferencia. Máximo 50 claves, clave de máximo 100 caracteres, valor de máximo 2000 caracteres. feeCharge: $ref: '#/components/schemas/FeeChargeObject' ErrorFormat: type: object description: El mensaje de error de la respuesta. required: - code - title - message properties: code: type: string description: Un identificador único y estable para el error. title: type: string description: Un breve resumen del problema. message: type: string description: Orientación detallada para resolver el error. TransferPartyObject: type: object description: Información de la parte de la cuenta (origen o destino). properties: key: type: string description: Clave Pix (si corresponde). example: john.doe@example.com account: type: object description: Detalles de la cuenta. properties: branch: type: string description: Código de la agencia bancaria. example: '0001' number: type: string description: Número de cuenta. example: '123456789' participant: type: string description: ISPB de la institución participante (8 dígitos). example: '12345678' type: type: string description: Tipo de cuenta. enum: - CACC - SVGS - TRAN - OTHR example: CACC owner: type: object description: Detalles del titular. properties: document: type: string description: Documento de identificación (CPF 11 dígitos o CNPJ 14 dígitos). example: '12345678901' name: type: string description: Nombre completo o razón social. example: John Doe tradeName: type: string description: Nombre comercial (opcional). example: John's Business type: type: string enum: - NATURAL_PERSON - LEGAL_PERSON description: Tipo de titular. example: NATURAL_PERSON LedgerInfoObject: type: object description: Identificadores de transacción y operación del ledger de Midaz. properties: transactionId: type: string description: Identificador de la transacción de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440011 sourceOperationId: type: string description: Identificador de la operación de origen (DEBIT) de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440012 destinationOperationId: type: string description: Identificador de la operación de destino (CREDIT) de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440013 revert: type: object description: >- Detalles de la transacción de reversión (presente solo cuando se rechaza y se revierte). properties: transactionId: type: string description: Identificador de la transacción de reversión de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440014 sourceOperationId: type: string description: >- Identificador de la operación de origen de reversión (DEBIT) de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440015 destinationOperationId: type: string description: >- Identificador de la operación de destino de reversión (CREDIT) de Midaz (UUID). example: 550e8400-e29b-41d4-a716-446655440016 FeeChargeObject: type: object description: Detalles del cálculo de tarifas (si corresponde). properties: applied: type: boolean description: Indica si se aplicaron tarifas. example: true calculationType: type: string description: Tipo de cálculo de la tarifa. example: segment totalAmount: type: string description: Monto total de la tarifa. example: '2.50' netAmount: type: string description: Monto neto después de las tarifas. example: '97.50' fees: type: array description: Lista de tarifas individuales aplicadas. items: type: object properties: feeLabel: type: string description: Etiqueta/nombre de la tarifa. example: PIX_FEE amount: type: string description: Monto de la tarifa. example: '1.50' creditAccount: type: string description: Cuenta que recibe la tarifa. example: 01989f9e-6508-79f8-9540-835be49fbd0d calculationType: type: string description: Cómo se calculó la tarifa. example: PERCENTAGE calculationValue: type: string description: El parámetro de cálculo (porcentaje o valor fijo). example: '1.5' examples: ErrorPIX0001: summary: Missing Headers in Request value: code: PIX-0001 title: Missing Headers in Request message: >- Your request is missing one or more required header params. Please refer to the documentation to ensure all necessary header params are included in your request. ErrorPIX0008: summary: Invalid Path Parameter in Request value: code: PIX-0008 title: Invalid Path Parameter in Request message: >- One or more path parameters are invalid. Please refer to the documentation to verify the expected format and allowed values for each path parameter. ErrorPIX0404: summary: Invalid UUID Format value: code: PIX-0404 title: Invalid UUID Format message: The UUID format is invalid. ErrorPIX0407: summary: Transfer Account Mismatch value: code: PIX-0407 title: Transfer Account Mismatch message: The transfer does not belong to the specified account. ErrorPIX0426: summary: Transfer Not Found value: code: PIX-0426 title: Transfer Not Found message: The transfer was not found. ErrorPIX0000: summary: Internal Server Error value: code: PIX-0000 title: Internal Server Error message: The server encountered an unexpected error. Please try again later. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````