> ## 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 recuperações MED aguardando devolver > Lista as recuperações de valores Analisada do lado do criador em que esta instituição ainda pode acionar o devolver, ordenadas por prazo de devolver (mais antigo primeiro). O ISPB do criador é derivado da configuração. Cada linha expõe devolverDeadline e uma flag breached calculada. Projeção de leitura — sem ida e volta ao upstream; nenhuma ação tomada e nenhum dinheiro movimentado. ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml GET /v1/med/recoveries/awaiting-devolver openapi: 3.0.3 info: title: Plugin BR Pix Direct - API Completa description: > API completa para o sistema de pagamentos instantaneos PIX brasileiro, incluindo operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes, transacoes e limites de transacao. 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 recuperações MED aguardando devolver description: >- Lista as recuperações de valores Analisada do lado do criador em que esta instituição ainda pode acionar o devolver, ordenadas por prazo de devolver (mais antigo primeiro). O ISPB do criador é derivado da configuração. Cada linha expõe devolverDeadline e uma flag breached calculada. Projeção de leitura — sem ida e volta ao upstream; nenhuma ação tomada e nenhum dinheiro movimentado. parameters: - description: Número máximo de linhas a retornar; 0 usa o padrão do servidor. explode: false in: query name: limit schema: description: Número máximo de linhas a retornar; 0 usa o padrão do 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: Erro components: schemas: RecoveryListBody: additionalProperties: false properties: data: description: A lista de recuperações de valores. items: $ref: '#/components/schemas/RecoveryView' type: array nullable: true required: - data type: object Detail: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina, escopado ao serviço emissor (formato: -NNNN). type: string detail: description: Uma explicação legível específica desta ocorrência do problema. type: string errors: description: Lista opcional de detalhes individuais de erro items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Uma referência URI que identifica a ocorrência específica do problema. format: uri type: string status: description: Código de status HTTP format: int64 type: integer title: description: >- Um resumo curto e legível do tipo de problema. Este valor não deve mudar entre ocorrências do erro. type: string type: default: about:blank description: Uma referência URI para a documentação legível do erro. format: uri type: string type: object RecoveryView: additionalProperties: false properties: breached: description: >- True quando o prazo de devolver foi atingido ou ultrapassado (computado no momento da leitura); false quando nenhum prazo está definido. type: boolean contatoEmail: description: E-mail de contato do criador. type: string contatoTelefone: description: Telefone de contato do criador. type: string detalhes: description: Detalhe em texto livre (obrigatório quando tpSituacao=4 Outros). type: string devolverDeadline: description: >- Prazo de 72h do lado do criador para devolver, a partir do encerramento da etapa de Analise; nulo a menos que esta instituição seja o pspCriador em uma recuperação Analisada. type: string dtHrCriacao: description: Data/hora de criação no upstream (RFC 3339 UTC). type: string dtHrUltModificacao: description: >- Data/hora da última modificação no upstream (RFC 3339 UTC) — o watermark. type: string idRecValores: description: GUID da recuperação de valores (a chave natural). type: string idTransacaoRaiz: description: EndToEndId da transação raiz sendo recuperada. type: string pspCriador: description: ISPB do criador da recuperação. type: string status: description: código de ciclo de vida stRecValores (0=Criada.. 6=Cancelada). format: int64 type: integer statusDescription: description: Rótulo legível de stRecValores. type: string tpSituacao: description: Código de situação (0..5). format: int64 type: integer tpSituacaoDescription: description: Rótulo legível 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: Onde o erro ocorreu, ex. 'body.items[3].tags' ou 'path.thing-id' type: string message: description: Texto da mensagem de erro type: string value: description: O valor no local informado type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticacao por token JWT Bearer. Obtenha o token no endpoint `/v1/login/oauth/access_token` usando credenciais do cliente (clientId e clientSecret). Inclua o token no header Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` O token expira apos 3600 segundos (1 hora). ````