List MED disputes (Special Return Mechanism)
Lists the disputes filed against this account, newest first.
The data is ours: the settlement bank exposes no lookup and no listing for infraction reports, so this endpoint reads what the pix.med.opened / pix.med.updated webhooks recorded. Subscribing to those webhooks is therefore part of integrating MED — see the Disputes guide.
reviewStatus is the stage of CorpX’s review (awaiting_defense, pending_review, info_requested, in_execution, awaiting_funds, refunded, refused, awaiting_result); lockStatus / lockedAmount show the balance held for the dispute, and refundedTotal / remaining the return totals. There is no filter by status.
The list has both kinds of dispute, told apart by direction: received (filed against this account, with defense and review) and opened (CorpX opened it on the holder’s behalf because the disputed PIX left this account; there is nothing to answer, and the write routes answer 409 med_opened_by_us). partnerStatus is the settlement bank’s status from the last webhook, always with lastUpdatedAt: for opened it is the only progress signal.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
Query parameters
Maximum number of items to return (page size).
Number of items to skip before the first returned item (pagination).