Skip to main content
GET
Fetch Disputes
Pass managedByChargeblast=true to return only the disputes Chargeblast fights on your behalf. Each dispute carries disputeStatus (needs_response, under_review, won, lost, …), isManagedByChargeblast, isSubmittedEvidenceByChargeblast and submissionDate. Fields that do not apply are omitted from the JSON rather than sent as null.
This endpoint is enabled per account. Ask your account manager to turn it on for your API key. Use startDate / endDate (ISO 8601 or yyyy-MM-dd) for incremental pulls. per defaults to 10 and is capped at 100.

Headers

X-API-Key
string
required

Your API key. Sent in the X-API-Key header.

Query Parameters

status
enum<string> | null

Filter by dispute status. Possible values: needs_response, under_review, charge_refunded, won, lost, protected, prevented.

Available options:
needs_response,
under_review,
charge_refunded,
won,
lost,
protected,
prevented
startDate
string | null

ISO8601 date (or date-only, e.g. 2026-06-01). Only return disputes opened on or after this date.

endDate
string | null

ISO8601 date (or date-only, e.g. 2026-06-01). Only return disputes opened on or before this date.

managedByChargeblast
boolean | null

Set to true to return only the disputes Chargeblast manages (the ones our team fights on your behalf). Omit to include every dispute; false is rejected.

page
integer<int64> | null

The starting page of the request. Default value of 1.

per
integer<int64> | null

How many objects to request per page. Default value of 10, capped at 100.

Response

200 - application/json

OK

disputes
object[]
required

The disputes for this page.

page
integer<int64>
required

The current page.

per
integer<int64>
required

How many objects are returned per page.

total
integer<int64>
required

Total number of disputes matching the filter.