claim.created

webhook

claim.created

Occurs when a dispute intake claim is created.

Payload

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

event_type

const

enum

required

The type of event that occurred.

Allowed:

token

uuid

required

Unique identifier for the claim, in UUID format

reference_id

string | null

required

Identifier for the claim as displayed in the Lithic dashboard. Populated depending on your program's setup, null otherwise. Use it to match claims received through the API and webhooks to the dashboard. This is not the claim token, which is the identifier to use in API requests

card_tokens

array of uuids

required

Tokens for the cards associated with the disputed transactions

card_tokens*

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*

reason

string

enum

required

Dispute reason code provided when creating the claim

status

string

enum

required

Current lifecycle status of the claim

Allowed:

outstanding_requirements

array of strings

required

Requirements that must be fulfilled before the claim can be submitted

outstanding_requirements*

Allowed:

submitted

date-time | null

required

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

Response

200

Return a 200 status to indicate that the data was received successfully