Skip to main content
GET
Get a single dispute by ID for organization

Authorizations

x-api-key
string
header
required

Company API key for authentication

Path Parameters

id
string
required

The dispute ID

Response

Dispute details with timeline

Dispute with its timeline of events, oldest first

id
string<uuid>
required

Internal dispute ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

transaction_id
string<uuid>
required

ID of the disputed transaction

Example:

"123e4567-e89b-12d3-a456-426614174001"

company_id
string<uuid>
required

Merchant the claim is filed against

Example:

"123e4567-e89b-12d3-a456-426614174002"

company_name
string | null
required

Trading name of the merchant the claim is filed against

Example:

"Acme"

company_full_name
string
required

Legal name of the merchant the claim is filed against

Example:

"Acme Payments LTDA"

organization_id
string<uuid>
required

Organization the merchant belongs to

Example:

"123e4567-e89b-12d3-a456-426614174003"

provider
enum<string>
required

Provider that processed the disputed transaction

Available options:
CELCOIN,
RINNE,
CAPPTA
Example:

"CELCOIN"

type
enum<string>
required

Rail the dispute arrived on

Available options:
PIX_INFRACTION,
CHARGEBACK
Example:

"PIX_INFRACTION"

status
enum<string>
required

Ordered progression; a dispute only moves forward. CLOSED is terminal, so a finished dispute is exactly status == CLOSED.

Available options:
OPEN,
UNDER_REVIEW,
CLOSED
Example:

"OPEN"

outcome
enum<string> | null
required

The verdict. Null until the dispute closes, and always set once it has. UPHELD means the claim succeeded and funds are returned; DISMISSED means it failed; WITHDRAWN means it ceased before a verdict, or the provider closed out a dismissed claim. A closed dispute's outcome may move between DISMISSED and WITHDRAWN without a further dispute.status-changed event; UPHELD never changes.

Available options:
UPHELD,
DISMISSED,
WITHDRAWN
Example:

null

amount
integer
required

Amount at risk in cents. Derived from the disputed transaction when the dispute is created (an upper bound rather than an exact figure); once the provider reports the exact amount it set out to hold, that figure supersedes the derived one.

Example:

9500

provider_dispute_id
string
required

The provider's own identifier for the dispute

Example:

"aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee"

dispute_details
string | null
required

Free text describing the dispute, directly or indirectly, as supplied by the reporting side. The author is not recorded and may be the payer, a risk analyst or a system.

Example:

"the reporting institution describes an unauthorised transfer"

deadline_at
string<date-time> | null
required

Provider-stated response deadline. Null where the rail states none.

Example:

null

concluded_at
string<date-time> | null
required

When the dispute concluded. Set exactly when status becomes CLOSED.

Example:

null

created_at
string<date-time>
required
Example:

"2026-08-05T15:16:57.000Z"

updated_at
string<date-time>
required
Example:

"2026-08-05T15:16:57.000Z"

timeline
object[]
required

Timeline of dispute events, oldest first