latestOpenAPI 3.1.02026-08-213914255.9 MB
715c4defcbbf
Disputes
List Disputes
Lists the disputes across the accounts you can read.
get/disputes
Query parameters
account_idstring
Only disputes filed against this account (biz_ tag). Omit it to cover every account you can read.
firstinteger
The number of disputes to return (default 20, max 100).
afterstring
A cursor; returns disputes after this position.
lastinteger
The number of disputes to return from the end of the range.
beforestring
A cursor; returns disputes before this position.
order'created_at' | 'amount' | 'evidence_due_at'
The field to sort disputes by.
direction'asc' | 'desc'
Sort direction.
statusstring[]
Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage. A needs_response dispute whose evidence deadline has passed reports and filters as under_review instead.
[ "needs_response" ]
currencystring
Only disputes in this three-letter ISO currency.
created_beforestring
Only disputes opened before this ISO 8601 timestamp.
created_afterstring
Only disputes opened after this ISO 8601 timestamp.
Headers
Api-Version-Datestring
Example:2026-08-21
Pins the request to a dated API version.
Response
disputes listed
Example response
{
"data": [
{
"account_id": "biz_xxxxxxxxxxxxxx",
"amount": 150,
"buyer": {
"email": "marcus@shinetime.example",
"member_id": "mber_xxxxxxxxxxxxxx",
"name": "Dana Whitfield",
"user_id": "user_xxxxxxxxxxxxxx",
"username": "danawhitfield"
},
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"evidence": {
"access_activity_log": "Vehicle checked in 2026-01-04 09:02, released 2026-01-05 16:40. Signed release on file.",
"billing_address": "4180 Burnet Rd, Austin, TX 78756, US",
"cancellation_policy_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"cancellation_policy_disclosure": "Shown at checkout and again in the booking confirmation email.",
"customer_communication_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"customer_email_address": "marcus@shinetime.example",
"customer_name": "Dana Whitfield",
"documents": [
{
"content_type": "image/png",
"document_type": "customer_order_history",
"filename": "customer-order-history.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
],
"notes": "Two-day ceramic coating completed and collected. Before and after photos attached.",
"product_description": "Two-stage paint correction with a three-year ceramic coating.",
"refund_policy_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"refund_policy_disclosure": "Linked from the booking page and accepted at checkout.",
"refund_refusal_explanation": "Work was completed and the vehicle collected, so the deposit is non-refundable.",
"service_date": "2026-01-01",
"uncategorized_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
},
"evidence_due_at": "2026-01-01T12:00:00.000Z",
"evidence_locked_reason": "submitted",
"evidence_submitted_at": "2026-01-01T12:00:00.000Z",
"generated_response_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"id": "dspt_xxxxxxxxxxxxxx",
"issuer_comments": [
{
"received_at": "2026-01-01T12:00:00.000Z",
"text": "Note: Cardholder states the ceramic coating appointment never took place\nCancellation method: By phone"
}
],
"payment": {
"amount": 249,
"card_brand": "visa",
"card_last4": "4242",
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"id": "pay_xxxxxxxxxxxxxx",
"payment_instrument": {
"card": {
"brand": "visa",
"last4": "4242"
},
"display_name": "Visa •••• 4242",
"icons": {
"card": {
"dark": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
},
"light": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
}
},
"square": {
"dark": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
},
"light": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
}
}
},
"payment_method_type": "card"
},
"payment_method_type": "card",
"payment_processor": "stripe"
},
"plan_id": "plan_xxxxxxxxxxxxxx",
"product_id": "prod_xxxxxxxxxxxxxx",
"reason": "other",
"reason_code": "13.1",
"status": "under_review",
"updated_at": "2026-01-01T12:00:00.000Z"
}
],
"page_info": {
"end_cursor": "WyJjdXJzb3IiLDFd",
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}