# Dispute

## Fields

- **dispute_token**: `uuid` (required)

- **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**: `array of strings` (required)
  - Unique identifiers for the dispute from the network.

- **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`: ATM cash misdispense.
    - `CANCELLED`: Transaction was cancelled by the customer.
    - `DUPLICATED`: The transaction was a duplicate.
    - `FRAUD_CARD_NOT_PRESENT`: Fraudulent transaction, card not present.
    - `FRAUD_CARD_PRESENT`: Fraudulent transaction, card present.
    - `FRAUD_OTHER`: Fraudulent transaction, other types such as questionable merchant activity.
    - `GOODS_SERVICES_NOT_AS_DESCRIBED`: The goods or services were not as described.
    - `GOODS_SERVICES_NOT_RECEIVED`: The goods or services were not received.
    - `INCORRECT_AMOUNT`: The transaction amount was incorrect.
    - `MISSING_AUTH`: The transaction was missing authorization.
    - `OTHER`: Other reason.
    - `PROCESSING_ERROR`: Processing error.
    - `REFUND_NOT_PROCESSED`: The refund was not processed.
    - `RECURRING_TRANSACTION_NOT_CANCELLED`: The recurring transaction was 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`: This case was lost at final arbitration.
    - `NETWORK_REJECTED`: Network rejected.
    - `NO_DISPUTE_RIGHTS_3DS`: No dispute rights, 3DS.
    - `NO_DISPUTE_RIGHTS_BELOW_THRESHOLD`: No dispute rights, below threshold.
    - `NO_DISPUTE_RIGHTS_CONTACTLESS`: No dispute rights, contactless.
    - `NO_DISPUTE_RIGHTS_HYBRID`: No dispute rights, hybrid.
    - `NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS`: No dispute rights, max chargebacks.
    - `NO_DISPUTE_RIGHTS_OTHER`: No dispute rights, other.
    - `PAST_FILING_DATE`: Past filing date.
    - `PREARBITRATION_REJECTED`: Prearbitration rejected.
    - `PROCESSOR_REJECTED_OTHER`: Processor rejected, other.
    - `REFUNDED`: Refunded.
    - `REFUNDED_AFTER_CHARGEBACK`: Refunded after chargeback.
    - `WITHDRAWN`: Withdrawn.
    - `WON_ARBITRATION`: Won arbitration.
    - `WON_FIRST_CHARGEBACK`: Won first chargeback.
    - `WON_PREARBITRATION`: Won prearbitration.

- **status**: `string` (enum) (required)
  - Status types:
    - `NEW`: New dispute case is opened.
    - `PENDING_CUSTOMER`: Lithic is waiting for customer to provide more information.
    - `SUBMITTED`: Dispute is submitted to the card network.
    - `REPRESENTMENT`: Case has entered second presentment.
    - `PREARBITRATION`: Case has entered prearbitration.
    - `ARBITRATION`: Case has entered arbitration.
    - `CASE_WON`: Case was won and credit will be issued.
    - `CASE_CLOSED`: Case was lost or withdrawn.

- **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.

## Example Response

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

## Error Responses

- **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.
- **404**: The specified resource was not found.
- **429**: Client has exceeded the number of allowed requests in a given time period.