LIlightsparkdev
Cards

Get a card dispute

Changed on

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

get/card-disputes/{disputeId}

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/card-disputes/{disputeId}
  • Auth
    HTTP basic

Response

The dispute.

idstring required

System-generated unique dispute identifier.

cardTransactionIdstring required

The id of the disputed CardTransaction.

cardIdstring

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

status'OPEN' | 'CLOSED' required

Whether the dispute is still active.

disposition'WON' | 'PARTIALLY_WON' | 'LOST' | 'WITHDRAWN' | 'DENIED'

The outcome the dispute closes with.

openedAtstring date-time

When the card issuer opened the dispute.

issuerUpdatedAtstring date-time

When the card issuer last changed the dispute.

createdAtstring date-time required

When Grid first recorded the dispute.

updatedAtstring date-time required

When Grid last updated the dispute.

Example response

{
  "id": "CardDispute:019542f5-b3e7-1d02-0000-000000000200",
  "cardTransactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000100",
  "cardId": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "status": "OPEN",
  "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",
  "createdAt": "2026-05-08T14:30:05Z",
  "updatedAt": "2026-05-09T09:12:46Z"
}

Changes