Get a card dispute

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

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId}")
  .get()
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

{
  "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"
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

GET

card-disputes

{disputeId}

Get a card dispute

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

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId}")
  .get()
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

{
  "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"
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

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

The dispute.

A cardholder's dispute of a settled card transaction.

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"

Using the API

API documentation

Get a card dispute

Authorizations

Path Parameters

Response