First Leeward

Disputes

Get dispute

GEThttps://api.firstleeward.com/v0/disputes/:id

Retrieves a single card dispute by its unique identifier.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

idstring<uuid>required

Card dispute ID

Response

200Card dispute resource
idstring<uuid>required

Unique dispute identifier

transactionIdstring<uuid>required

The card transaction being disputed

cardIdstring<uuid>required

Card used for the disputed transaction

statusstringrequired

Current dispute status

Available options:RECEIVEDREVIEWINGSUBMITTEDWONLOSTREFUNDEDDECLINEDCANCELED
reasonstringrequired

Why the cardholder is disputing the transaction

Available options:FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEITFRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEITFRAUD_OTHER_CARD_PRESENTFRAUD_OTHER_CARD_ABSENTFRAUD_VISA_MONITORING_PROGRAMAUTHORIZATION_CARD_RECOVERY_BULLETINAUTHORIZATION_DECLINEDAUTHORIZATION_NO_AUTH_LATE_PRESENTMENTPROCESSING_ERROR_INCORRECT_TRANSACTION_CODEPROCESSING_ERROR_INCORRECT_CURRENCYPROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBERPROCESSING_ERROR_INCORRECT_AMOUNTPROCESSING_ERROR_DUPLICATE_PROCESSINGPROCESSING_ERROR_INVALID_DATACONSUMER_MERCHANDISE_NOT_RECEIVEDCONSUMER_CANCELLED_RECURRINGCONSUMER_NOT_AS_DESCRIBEDCONSUMER_COUNTERFEIT_MERCHANDISECONSUMER_MISREPRESENTATIONCONSUMER_CREDIT_NOT_PROCESSEDCONSUMER_CANCELLED_MERCHANDISECONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTEDCONSUMER_NON_RECEIPT_CASH_ATM
categorystringrequired

The grouping the reason belongs to

Available options:FRAUDAUTHORIZATIONPROCESSING_ERRORCONSUMER
amountobjectrequired

The cardholder amount under dispute, including FX and ATM fees. May be less than the transaction total.

Show child attributes
valuenumberrequired

Disputed amount

currencystringrequired

Currency of the disputed amount

refundedAmountobject | nullrequired

Amount credited to the cardholder when the dispute reaches REFUNDED. Includes the network refund plus a prorated FX markup and ATM variable fee. Does not include the per-withdrawal ATM fixed fee, which stays charged. Null until REFUNDED. May be less than the disputed amount. The same credit is recorded as a DISPUTE_REFUND event on the disputed card transaction and delivered in CARD_TRANSACTION_UPDATED; apply balance changes from that event, not from this field.

Show child attributes
valuenumberrequired

Amount credited to the cardholder

currencystringrequired

Currency of the refunded amount

cardholderobjectrequired

Cardholder identity on the case

Show child attributes
namestringrequired

Cardholder name on the case

emailstring<email>required

Cardholder email on the case

contactEmailstring<email>required

Address that receives the dispute outcome

resolvedAtstring<date-time> | nullrequired

When the dispute reached a final status, or null while open

createdAtstring<date-time>required

ISO 8601 timestamp of creation

updatedAtstring<date-time>required

ISO 8601 timestamp of last update

404Card dispute not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired