List chargeback requests

Status

Filter by status.

• ARBITRATION
• CASE_CLOSED
• CASE_WON
• NEW
• PENDING_CUSTOMER
• PREARBITRATION
• REPRESENTMENT
• SUBMITTED

Transaction Tokens

Array of uuids (length ≤ 50)

Date Range

• begin: Date string in RFC 3339 format.
• end: Date string in RFC 3339 format.

Pagination

• page_size: 1 to 100 (Defaults to 50)
• starting_after: Cursor token for pagination.
• ending_before: Cursor token for pagination.

Response Structure

200 OK

{ "data": [ { "amount": [integer], "arbitration_date": [date-time | null], "created": [date-time], "customer_filed_date": [date-time | null], "customer_note": [string | null], "network_claim_ids": [array], "network_filed_date": [date-time | null], "network_reason_code": [string | null], "prearbitration_date": [date-time | null], "primary_claim_id": [string | null], "reason": enum, "representment_date": [date-time | null], "resolution_date": [date-time | null], "resolution_note": [string | null], "resolution_reason": [string | null], "status": enum, "token": [uuid], "transaction_token": [uuid] } ], "has_more": [boolean] }

Possible Return Codes

• 400: A parameter in the query given does not match the valid queries.
• 401: Authentication error, invalid or missing API key.
• 422: Unprocessable entity.
• 429: Client has exceeded allowed requests.

Example Request

curl --request GET \
     --url 'https://sandbox.lithic.com/v1/disputes?page_size=50' \
     --header 'accept: application/json'

Example Response

{
  "data": [
    {
      "amount": 0,
      "arbitration_date": "2026-07-18T00:25:22.425Z",
      "created": "2026-07-18T00:25:22.425Z",
      "customer_filed_date": "2026-07-18T00:25:22.425Z",
      "customer_note": "string",
      "network_claim_ids": ["string"],
      "network_filed_date": "2026-07-18T00:25:22.425Z",
      "network_reason_code": "string",
      "prearbitration_date": "2026-07-18T00:25:22.425Z",
      "primary_claim_id": "string",
      "reason": "ATM_CASH_MISDISPENSE",
      "representment_date": "2026-07-18T00:25:22.425Z",
      "resolution_date": "2026-07-18T00:25:22.425Z",
      "resolution_note": "string",
      "resolution_reason": "CASE_LOST",
      "status": "ARBITRATION",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "has_more": true
}