Skip to navigation

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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Query parameters

limitintegerOptional<=200Defaults to 50

Maximum number of items to return (page size).

offsetintegerOptionalDefaults to 0

Number of items to skip before the first returned item (pagination).

Response

Disputes found.
itemslist of objects
countinteger
accountIdstringOptional
tenantIdstringOptional
limitintegerOptional
offsetintegerOptional

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error