---
title: "List the disputes on a card transaction"
method: GET
path: "/transactions/{transactionId}/disputes"
tags: ["Cards"]
---

# List the disputes on a card transaction

`GET /transactions/{transactionId}/disputes`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/transactions/{transactionId}/disputes`
- Auth: HTTP basic

Returns every dispute on a card transaction, newest first. Opening a dispute does not change the transaction's `status`.

## Response `200`

The transaction's disputes.

- CardDisputeListResponse: The disputes on one card transaction. The list is not paginated.
  - `data` CardDispute[], required: The transaction's disputes.
    - `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`: Transaction 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/transactions/:transactionId/disputes/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)