Disputes

Fetch Disputes

Get all the chargeback disputes from your Chargeblast account. Each dispute includes linked alert, deflection, and evidence-submission data where available — roughly matching what the Chargeblast dashboard shows for a dispute.

get/api/v2/disputes

Request

  • Base URL: https://api.chargeblast.com
  • URL: https://api.chargeblast.com/api/v2/disputes
  • Auth: none declared. Required headers: X-API-Key

Query parameters

status'needs_response' | 'under_review' | 'charge_refunded' | 'won' | 'lost' | 'protected' | 'prevented' nullable

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

startDatestring nullable

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

endDatestring nullable

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

managedByChargeblastboolean nullable

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.

pageinteger nullable

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

perinteger nullable

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

Headers

X-API-Keystring required

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

Response

OK

pageinteger required

The current page.

perinteger required

How many objects are returned per page.

totalinteger required

Total number of disputes matching the filter.

Example response

{
  "disputes": [
    {
      "alerts": [
        {
          "attributes": {
            "order_number": "#1533",
            "processor_id": "proc_b381c83a9bc8a93"
          }
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.