Skip to main content
GET
/
v1
/
disputes
/
{id}
Retrieve
curl --request GET \
  --url https://{defaultHost}/v1/disputes/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "a91e53bc-6546-4903-9b3b-ffc189a0cacb",
  "object": "dispute",
  "amount": 2900,
  "currency": "usd",
  "external_dispute_id": "dp_2iaia1pe9xtitjyrwgbk7m8r",
  "live_mode": true,
  "processor_type": "stripe",
  "status": "pending",
  "charge": "fb7a5f3d-e8fd-4c1a-bbec-1782e8057baa",
  "created_at": 1767909697,
  "updated_at": 1767909697
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
amount
integer

The amount in cents that is disputed, represented as a whole integer. For example 9900 is equivalent to $99.

​
currency
string

Three-letter ISO currency code, in lowercase.

​
external_dispute_id
string

The external processor ID representing this dispute.

​
live_mode
boolean

Set to true if this dispute is in live mode, and set to false if it is in test mode.

​
processor_type
string

The type of associated processor – one of mock, mollie, paypal, paystack, or stripe.

​
status
string

The current status of this dispute, which can be one of pending, won, or lost.

​
charge

Expandable – The associated charge ID.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.