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
Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).
Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.
Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.
Query parameters
Maximum number of items to return (page size).
Number of items to skip before the first returned item (pagination).