Skip to content
Stainless Stainless Stainless SDKs

Create

Initiate dispute
post/v1/disputes

Initiate a dispute.

Body Parameters
amountnumber

Amount to dispute

reasonenum
Accepts one of the following: "ATM_CASH_MISDISPENSE", "CANCELLED", "DUPLICATED", 11 more

Reason for dispute

Hide ParametersShow Parameters
"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"
transaction_tokenstring

Transaction to dispute

formatuuid
customer_filed_datestring
optional

Date the customer filed the dispute

formatdate-time
customer_notestring
optional

Customer description of dispute

maximum5000
Returns
tokenstringamountnumberarbitration_datestringcreatedstringcustomer_filed_datestringcustomer_notestringnetwork_claim_idsarray of stringnetwork_filed_datestringnetwork_reason_codestringprearbitration_datestringprimary_claim_idstringreasonenumrepresentment_datestringresolution_datestringresolution_notestringresolution_reasonenumstatusenumtransaction_tokenstringDispute
Request example Request
curl https://api.lithic.com/v1/disputes \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "amount": 10000,
      "reason": "FRAUD_CARD_PRESENT",
      "transaction_token": "12345624-aa69-4cbc-a946-30d90181b621"
    }'
200 Example
{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "amount": 0,
  "arbitration_date": "2019-12-27T18:11:19.117Z",
  "created": "2019-12-27T18:11:19.117Z",
  "customer_filed_date": "2019-12-27T18:11:19.117Z",
  "customer_note": "customer_note",
  "network_claim_ids": [
    "string"
  ],
  "network_filed_date": "2019-12-27T18:11:19.117Z",
  "network_reason_code": "network_reason_code",
  "prearbitration_date": "2019-12-27T18:11:19.117Z",
  "primary_claim_id": "primary_claim_id",
  "reason": "ATM_CASH_MISDISPENSE",
  "representment_date": "2019-12-27T18:11:19.117Z",
  "resolution_date": "2019-12-27T18:11:19.117Z",
  "resolution_note": "resolution_note",
  "resolution_reason": "CASE_LOST",
  "status": "ARBITRATION",
  "transaction_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}