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.
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.