MED 2.0 — Consultar Recuperações de Valores

Além dos webhooks de acompanhamento, você pode consultar as recuperações de valores abertas contra a sua conta: a listagem devolve todas as recuperações recebidas, e a consulta individual devolve o detalhe de uma recuperação a partir do seu funds_recovery_id — o mesmo identificador recebido no webhook.

Listar recuperações de valores

ENDPOINT

/internal/pix/funds_recovery/incoming

MÉTODO

GET

Query params

Campo	Tipo	Descrição
funds_recovery_status	string	Filtra pelo status da recuperação: awaiting_analysis, pending_approval, completed ou cancelled.
initial_date	string	Filtra recuperações criadas a partir desta data. Formato YYYY-MM-DD.
final_date	string	Filtra recuperações criadas até esta data. Formato YYYY-MM-DD.
page_number	integer	Página da listagem. Padrão: 1.
page_size	integer	Itens por página. Padrão: 10, máximo: 30.

Response

STATUS

200

Response Body

{
  "data": [
    {
      "funds_recovery_key": "9eb5f452-81fd-4f67-9f2a-49e14e53ef64",
      "funds_recovery_id": "b8d19bd4-51dc-4784-a2ad-52807c6dfc80",
      "infraction_report_id": "3541127e-cbc9-44f6-bb0e-3e346ddaefb4",
      "pix_transfer_key": "957ef961-1824-47e6-90fd-f8b4775a1e1c",
      "target_account_key": "6711e3cf-fdf4-41b4-88e8-0a31cb83b9f4",
      "target_person_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
      "end_to_end_id": "E12345678202607161648s188f18bJty",
      "funds_recovery_status": "awaiting_analysis",
      "situation_type": "scam",
      "report_details": "Transação acusada como fraudulenta pelo originador.",
      "infraction_amount": 150.50,
      "credited_participant": "32402502",
      "debited_participant": "12345678",
      "analysis_result": null,
      "analysis_details": null,
      "blocked_balance_status": "completelly_blocked",
      "tracking_graph": null,
      "funds_recovery_status_events": [
        {
          "old_status": null,
          "new_status": "awaiting_analysis",
          "created_at": "2026-07-16T16:48:43Z"
        }
      ],
      "updated_at": "2026-07-16T16:48:43Z",
      "created_at": "2026-07-16T16:48:43Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": null,
    "rows_per_page": 10
  }
}

Campo	Tipo	Descrição
data *	array	Lista de recuperações de valores abertas contra a sua conta, da mais recente para a mais antiga. Objeto funds_recovery
pagination *	object	Dados de paginação: current_page, next_page (nulo na última página) e rows_per_page.

Consultar uma recuperação de valores

ENDPOINT

/internal/pix/funds_recovery/incoming/FUNDS_RECOVERY_ID

MÉTODO

GET

Path params

Campo	Tipo	Descrição	Caracteres
FUNDS_RECOVERY_ID *	string	Identificador da recuperação de valores no Bacen (funds_recovery_id).	32

Response

STATUS

200

A resposta é o objeto funds_recovery, incluindo o histórico de eventos de status (funds_recovery_status_events) e, quando a recuperação já foi respondida, o campo client_awnser.