claim.created

A claim represents a dispute filing initiated through the Dispute Intake API.

event_type

• const
• enum
• required

The type of event that occurred.

• claim.created

Allowed:

• claim.created

token

• uuid
• required

Unique identifier for the claim, in UUID format

card_tokens

• array of uuids
• required

Tokens for the cards associated with the disputed transactions

account_token

• uuid | null
• required

Token for the account associated with the claim

account_holder_token

• uuid | null
• required

Token for the account holder that filed the claim

created

• date-time
• required

When the claim was created

updated

• date-time
• required

When the claim was last updated

disputed_transactions

• array of objects
• required

Transactions included in this claim

disputed_transactions *

• object

A transaction included in a claim, along with the specific events being disputed.

transaction_token

• uuid
• required

Token for the transaction being disputed, in UUID format

event_tokens

• array of uuids
• required

Tokens for the specific events within the transaction being disputed. Lithic creates one dispute per event token

reason

• string
• enum
• required

Dispute reason code provided when creating the claim.

• Allowed reasons include:
  • CARD_NOT_PRESENT
  • CARD_LOST
  • CARD_STOLEN
  • CARD_NEVER_RECEIVED
  • COUNTERFEIT
  • ACCOUNT_TAKEOVER
  • PRODUCT_NOT_RECEIVED
  • NOT_AS_DESCRIBED
  • CREDIT_NOT_PROCESSED
  • CANCELLED_RECURRING
  • PAID_BY_OTHER_MEANS
  • DUPLICATE_CHARGE
  • LATE_PRESENTMENT
  • INCORRECT_TRANSACTION_CODE
  • NO_AUTHORIZATION
  • DECLINED
  • INCORRECT_AMOUNT
  • ATM_CASH_NOT_DISPENSED
  • ATM_DEPOSIT_WRONG_AMOUNT
  • ATM_DEPOSIT_MISSING

status

• string
• enum
• required

Current lifecycle status of the claim.

• Allowed statuses include:
  • INITIALIZING
  • AWAITING_INFO
  • SUBMITTED
  • RESOLVED
  • ABANDONED

outstanding_requirements

• array of strings
• required

Requirements that must be fulfilled before the claim can be submitted.

• Allowed requirements include:
  • QUESTIONNAIRE
  • DOCUMENTS

submitted

• date-time | null
• required

When the claim was submitted. Null until the claim reaches SUBMITTED status.

{
  "event_type": "claim.created",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "card_tokens": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "account_holder_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": "2026-07-18T00:26:09.562Z",
  "updated": "2026-07-18T00:26:09.562Z",
  "disputed_transactions": [
    {
      "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "event_tokens": [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      ]
    }
  ],
  "reason": "CARD_NOT_PRESENT",
  "status": "INITIALIZING",
  "outstanding_requirements": [
    "QUESTIONNAIRE"
  ],
  "submitted": "2026-07-18T00:26:09.562Z"
}