## dispute_token

token

uuid

required

---

## amount

integer

Amount for chargeback

## customer_filed_date

date-time

Date the customer filed the chargeback request

## customer_note

string

Customer description

## reason

string

enum

Reason for chargeback

ATM_CASH_MISDISPENSE, CANCELLED, DUPLICATED, FRAUD_CARD_NOT_PRESENT, FRAUD_CARD_PRESENT, FRAUD_OTHER, GOODS_SERVICES_NOT_AS_DESCRIBED, GOODS_SERVICES_NOT_RECEIVED, INCORRECT_AMOUNT, MISSING_AUTH, OTHER, PROCESSING_ERROR, RECURRING_TRANSACTION_NOT_CANCELLED, REFUND_NOT_PROCESSED

Show 14 enum values

# `200      OK`

object

### Dispute

#### amount

integer

required

Amount under dispute. May be different from the original transaction amount.

#### arbitration_date

date-time | null

required

Date dispute entered arbitration.

#### created

date-time

required

Timestamp of when first Dispute was reported.

#### customer_filed_date

date-time | null

required

Date that the dispute was filed by the customer making the dispute.

#### customer_note

string | null

required

End customer description of the reason for the dispute.

#### network_claim_ids

required

Unique identifiers for the dispute from the network.

array null

network_claim_ids array of strings

#### network_filed_date

date-time | null

required

Date that the dispute was submitted to the network.

#### network_reason_code

string | null

required

Network reason code used to file the dispute.

#### prearbitration_date

date-time | null

required

Date dispute entered pre-arbitration.

#### primary_claim_id

string | null

required

Unique identifier for the dispute from the network. If there are multiple, this will be the first claim id set by the network

#### reason

string

enum

required

Dispute reason:

- `ATM_CASH_MISDISPENSE`
- `CANCELLED`
- `DUPLICATED`
- `FRAUD_CARD_NOT_PRESENT`
- `FRAUD_CARD_PRESENT`
- `FRAUD_OTHER`
- `GOODS_SERVICES_NOT_AS_DESCRIBED`
- `GOODS_SERVICES_NOT_RECEIVED`
- `INCORRECT_AMOUNT`
- `MISSING_AUTH`
- `OTHER`
- `PROCESSING_ERROR`
- `REFUND_NOT_PROCESSED`
- `RECURRING_TRANSACTION_NOT_CANCELLED`

#### representment_date

date-time | null

required

Date the representment was received.

#### resolution_date

date-time | null

required

Date that the dispute was resolved.

#### resolution_note

string | null

required

Note by Dispute team on the case resolution.

#### resolution_reason

string | null

enum

required

Reason for the dispute resolution:

- `CASE_LOST`
- `NETWORK_REJECTED`
- `NO_DISPUTE_RIGHTS_3DS`
- `NO_DISPUTE_RIGHTS_BELOW_THRESHOLD`
- `NO_DISPUTE_RIGHTS_CONTACTLESS`
- `NO_DISPUTE_RIGHTS_HYBRID`
- `NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS`
- `NO_DISPUTE_RIGHTS_OTHER`
- `PAST_FILING_DATE`
- `PREARBITRATION_REJECTED`
- `PROCESSOR_REJECTED_OTHER`
- `REFUNDED`
- `REFUNDED_AFTER_CHARGEBACK`
- `WITHDRAWN`
- `WON_ARBITRATION`
- `WON_FIRST_CHARGEBACK`
- `WON_PREARBITRATION`
- `null`

#### status

string

enum

required

Status types:

- `NEW`
- `PENDING_CUSTOMER`
- `SUBMITTED`
- `REPRESENTMENT`
- `PREARBITRATION`
- `ARBITRATION`
- `CASE_WON`
- `CASE_CLOSED`

#### token

uuid

required

Globally unique identifier.

#### transaction_token

uuid

required

The transaction that is being disputed. A transaction can only be disputed once but may have multiple dispute cases.

# `400      A parameter in the query given in the request does not match the valid queries for the endpoint.`

# `401 User has not been authenticated`

Invalid or missing API key.

API key is not active.

The API key used is no longer active.

Could not find API key.

The API key provided is not associated with any user.

Please provide API key in Authorization header.

The Authorization header is not in the request.

Please provide API key in the form Authorization: [api-key].

The Authorization header is not formatted properly.

Insufficient privileges. Issuing API key required.

Write access requires an Issuing API key. Reach out at [lithic.com/contact](/content/contact/index.html).

Insufficient privileges to create virtual cards.

Creating virtual cards requires an additional privilege.

# `404      The specified resource was not found.`

# `422      Unprocessable entity.`

# `429      Client has exceeded the number of allowed requests in a given time period.`

Rate limited, too many requests per second.

User has exceeded their per second rate limit.

Rate limited, reached daily limit.

User has exceeded their daily rate limit.

Rate limited, too many keys tried.

One IP has queried too many different API keys.

## Example Request

```curl
curl --request PATCH \
     --url https://sandbox.lithic.com/v1/disputes/dispute_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 0,
  "customer_filed_date": "2026-07-18T00:25:20.126Z",
  "customer_note": "string",
  "reason": "ATM_CASH_MISDISPENSE"
}
'
```

## Example Response

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