MED 2.0 — Querying Funds Recoveries

In addition to the follow-up webhooks, you can query the funds recoveries opened against your account: the listing returns all received funds recoveries, and the individual query returns the details of a funds recovery from its funds_recovery_id — the same identifier received in the webhook.

List funds recoveries

ENDPOINT

/internal/pix/funds_recovery/incoming

METHOD

GET

Query params

Field	Type	Description
funds_recovery_status	string	Filters by the funds recovery status: awaiting_analysis, pending_approval, completed or cancelled.
initial_date	string	Filters funds recoveries created from this date onwards. Format YYYY-MM-DD.
final_date	string	Filters funds recoveries created up to this date. Format YYYY-MM-DD.
page_number	integer	Listing page. Default: 1.
page_size	integer	Items per page. Default: 10, maximum: 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": "Transaction reported as fraudulent by the originator.",
      "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
  }
}

Field	Type	Description
data *	array	List of funds recoveries opened against your account, from the most recent to the oldest. funds_recovery object
pagination *	object	Pagination data: current_page, next_page (null on the last page) and rows_per_page.

Query a funds recovery

ENDPOINT

/internal/pix/funds_recovery/incoming/FUNDS_RECOVERY_ID

METHOD

GET

Path params

Field	Type	Description	Characters
FUNDS_RECOVERY_ID *	string	Identifier of the funds recovery at Bacen (funds_recovery_id).	32

Response

STATUS

200

The response is the funds_recovery object, including the status event history (funds_recovery_status_events) and, when the funds recovery has already been responded to, the client_awnser field.