First Leeward

Disputes

List disputes

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

Returns a paginated list of card disputes, newest first. Filter by status, reason, category, card, transaction, or filed time range. No status default is applied.

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

Query Parameters

limitintegerdefault: 20

Maximum number of items to return (1-100, default: 20)

cursorstring

Opaque cursor for pagination. Pass nextCursor from previous response to get next page.

statusstring[]

Filter by dispute status (comma-separated)

Available options:RECEIVEDREVIEWINGSUBMITTEDWONLOSTREFUNDEDDECLINEDCANCELED
reasonstring[]

Filter by dispute reason (comma-separated)

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
categorystring[]

Filter by dispute category (comma-separated)

Available options:FRAUDAUTHORIZATIONPROCESSING_ERRORCONSUMER
cardIdstring<uuid>

Filter by card ID

transactionIdstring<uuid>

Filter by card transaction ID

filedFromstring<date-time>

Inclusive lower bound on when the dispute was filed. ISO 8601 datetime.

filedTostring<date-time>

Inclusive upper bound on when the dispute was filed. ISO 8601 datetime.

Response

200Response for status 200
itemsobject[]required
Show child attributes
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

nextCursorstring | nullrequired

Cursor for next page, or null if no more items