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. There is no dispute status here, and no filter by it. Without a lookup at the settlement bank the stored state cannot be confirmed, so the endpoint exposes what is verifiable instead: whether you answered (`answered`) and your deadline (`clientAnswerDeadline`). To track state, accumulate the `pix.med.updated` events — their `status` is accurate for the instant of the event.

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