---
title: "Get a card dispute"
method: GET
path: "/card-disputes/{disputeId}"
tags: ["Cards"]
---

# Get a card dispute

`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

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

## Response `200`

The dispute.

- CardDispute: A cardholder's dispute of a settled card transaction.
  - `id` string, required: System-generated unique dispute identifier.
  - `cardTransactionId` string, required: The id of the disputed `CardTransaction`.
  - `cardId` string: 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.
  - `disputedAmount` CurrencyAmount
    - `amount` integer, required: Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC)
    - `currency` Currency, required
      - `code` string: Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
      - `name` string: Full name of the currency
      - `symbol` string: Symbol of the currency
      - `decimals` integer: Number of decimal places for the currency
  - `provisionalCreditAmount` CurrencyAmount
    - `amount` integer, required: Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC)
    - `currency` Currency, required
      - `code` string: Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
      - `name` string: Full name of the currency
      - `symbol` string: Symbol of the currency
      - `decimals` integer: Number of decimal places for the currency
  - `openedAt` string, date-time: When the card issuer opened the dispute.
  - `issuerUpdatedAt` string, date-time: When the card issuer last changed the dispute.
  - `createdAt` string, date-time, required: When Grid first recorded the dispute.
  - `updatedAt` string, date-time, required: When Grid last updated the dispute.

## Other responses

- `401`: Unauthorized
- `404`: Dispute not found
- `500`: Internal service error

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-23** `81fd7eea1e77`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/card-disputes/:disputeId/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)