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

{
  "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.