> ## 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. # Listar recuperaciones MED a la espera de devolver > Lista las recuperaciones de valores Analisada del lado del creador sobre las que esta institución aún puede disparar devolver, ordenadas por plazo de devolver (primero las más próximas). El ISPB creador se deriva de la configuración. Cada fila expone devolverDeadline y un indicador breached calculado. Proyección de lectura: sin ida y vuelta al upstream; no se realiza ninguna acción ni se mueve dinero. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml GET /v1/med/recoveries/awaiting-devolver openapi: 3.0.3 info: title: Plugin BR Pix Directo - 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.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/med/recoveries/awaiting-devolver: get: tags: - MED API summary: Listar recuperaciones MED a la espera de devolver description: >- Lista las recuperaciones de valores Analisada del lado del creador sobre las que esta institución aún puede disparar devolver, ordenadas por plazo de devolver (primero las más próximas). El ISPB creador se deriva de la configuración. Cada fila expone devolverDeadline y un indicador breached calculado. Proyección de lectura: sin ida y vuelta al upstream; no se realiza ninguna acción ni se mueve dinero. parameters: - description: Maximum number of rows to return; 0 uses the server default. explode: false in: query name: limit schema: description: >- Número máximo de filas a devolver; 0 usa el valor por defecto del servidor. format: int64 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/RecoveryListBody' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: RecoveryListBody: additionalProperties: false properties: data: description: La lista de recuperaciones de valores. items: $ref: '#/components/schemas/RecoveryView' type: array nullable: true required: - data type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio emisor (formato: -NNNN). type: string detail: description: >- Una explicación legible para humanos específica de esta ocurrencia del problema. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. format: uri type: string status: description: Código de estado HTTP format: int64 type: integer title: description: >- Un resumen breve y legible para humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. type: string type: default: about:blank description: >- Una referencia URI a la documentación legible para humanos del error. format: uri type: string type: object RecoveryView: additionalProperties: false properties: breached: description: >- True cuando el plazo de devolver se ha alcanzado o superado (calculado en el momento de la lectura); false cuando no hay plazo definido. type: boolean contatoEmail: description: Correo electrónico de contacto del creador. type: string contatoTelefone: description: Teléfono de contacto del creador. type: string detalhes: description: Detalle de texto libre (obligatorio cuando tpSituacao=4 Outros). type: string devolverDeadline: description: >- Plazo de devolver de 72 h del lado del creador, desde el cierre de la etapa de Análise; null salvo que esta institución sea el pspCriador en una recuperación Analisada. type: string dtHrCriacao: description: Marca de tiempo de creación en el upstream (RFC 3339 UTC). type: string dtHrUltModificacao: description: >- Marca de tiempo de la última modificación en el upstream (RFC 3339 UTC): la marca de agua. type: string idRecValores: description: GUID de la recuperación de valores (la clave natural). type: string idTransacaoRaiz: description: EndToEndId de la transacción raíz que se está recuperando. type: string pspCriador: description: ISPB del creador de la recuperación. type: string status: description: Código de ciclo de vida stRecValores (0=Criada.. 6=Cancelada). format: int64 type: integer statusDescription: description: Etiqueta legible para humanos de stRecValores. type: string tpSituacao: description: Código de situación (0..5). format: int64 type: integer tpSituacaoDescription: description: Etiqueta legible para humanos de tpSituacao. type: string required: - idRecValores - idTransacaoRaiz - tpSituacao - tpSituacaoDescription - contatoEmail - contatoTelefone - pspCriador - status - statusDescription - dtHrCriacao - dtHrUltModificacao - breached type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticación con token JWT Bearer. Obtén el token desde el endpoint `/v1/login/oauth/access_token` usando credenciales de cliente (`clientId` y `clientSecret`). Incluye el token en el encabezado Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` El token expira después de 3600 segundos (1 hora). ````