Get a card dispute

Returns one dispute on a card transaction the platform owns. A dispute not yet linked to a transaction returns 404.

GET /card-disputes/{disputeId}

Get a card dispute

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId} \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "id": "CardDispute:019542f5-b3e7-1d02-0000-000000000200",
  "cardTransactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000100",
  "status": "OPEN",
  "createdAt": "2026-05-08T14:30:05Z",
  "updatedAt": "2026-05-09T09:12:46Z",
  "cardId": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "disposition": "WON",
  "disputedAmount": {
    "amount": 12550,
    "currency": {
      "code": "USD",
      "name": "United States Dollar",
      "symbol": "$",
      "decimals": 2
    }
  },
  "provisionalCreditAmount": {
    "amount": 12550,
    "currency": {
      "code": "USD",
      "name": "United States Dollar",
      "symbol": "$",
      "decimals": 2
    }
  },
  "openedAt": "2026-05-08T14:30:00Z",
  "issuerUpdatedAt": "2026-05-09T09:12:44Z"
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

disputeId · string · required

The id of the dispute.

Response

200

application/json

The dispute.

A cardholder's dispute of a settled card transaction.

id · string · required · read-only

System-generated unique dispute identifier.

Example:

"CardDispute:019542f5-b3e7-1d02-0000-000000000200"

cardTransactionId · string · required

The id of the disputed CardTransaction.

Example:

"Transaction:019542f5-b3e7-1d02-0000-000000000100"

status · enum<string> · required

Whether the dispute is still active.

Available options: OPEN, CLOSED

Example:

"OPEN"

createdAt · string<date-time> · required

When Grid first recorded the dispute.

Example:

"2026-05-08T14:30:05Z"

updatedAt · string<date-time> · required

When Grid last updated the dispute.

Example:

"2026-05-09T09:12:46Z"

cardId · string

The id of the Card the disputed transaction was made on.

Example:

"Card:019542f5-b3e7-1d02-0000-000000000010"

disposition · enum<string>

How the dispute ended. Absent while it is open.

Available options: WON, PARTIALLY_WON, LOST, WITHDRAWN, DENIED

Example:

"WON"

disputedAmount · object

The amount under dispute, as filed. Absent until the card issuer allocates one.

Show child attributes

provisionalCreditAmount · object

Credits granted minus credits reversed. Absent until the first credit event. The money settles asynchronously, so this amount can change before the cardholder's balance does.

Show child attributes

openedAt · string<date-time>

When the card issuer opened the dispute.

Example:

"2026-05-08T14:30:00Z"

issuerUpdatedAt · string<date-time>

When the card issuer last changed the dispute.

Example:

"2026-05-09T09:12:44Z"