Fetch Disputes
curl --request GET \
--url https://api.chargeblast.com/api/v2/disputes \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://api.chargeblast.com/api/v2/disputes"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://api.chargeblast.com/api/v2/disputes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.chargeblast.com/api/v2/disputes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.chargeblast.com/api/v2/disputes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.chargeblast.com/api/v2/disputes")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.chargeblast.com/api/v2/disputes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"disputes": [
{
"dispute": {
"transactionDate": "2023-11-07T05:31:56Z",
"disputeDate": "2023-11-07T05:31:56Z",
"amount": 123,
"source": "Stripe",
"chargeId": "<string>",
"brand": "mastercard",
"userId": "<string>",
"daysLeftToRespond": "<string>",
"supportsAutoRepresentment": true,
"id": "<string>",
"submittedEvidence": true,
"currency": "<string>",
"customer": "<string>",
"refunded": true,
"descriptor": "<string>",
"status": "succeeded",
"last4": "<string>",
"shop": "<string>",
"bin": "<string>",
"wallet": "apple_pay",
"accountId": "<string>",
"funding": "credit",
"createdAt": "2023-11-07T05:31:56Z",
"subscriptionId": "<string>",
"subAccountId": "<string>",
"disputeStatus": "needs_response",
"reason": "<string>",
"isRDR": true,
"riskScore": 123,
"issuer": "<string>",
"amountUSD": 123,
"customerEmail": "<string>",
"authorizationCode": "<string>",
"streamId": "<string>",
"arn": "<string>",
"is3DS": true,
"expirationDate": "2023-11-07T05:31:56Z",
"kind": "chargeback",
"explanation": "alert_not_handled",
"alertId": "<string>",
"externalUrl": "<string>",
"winLikelihood": {
"score": 123,
"computedAt": "2023-11-07T05:31:56Z",
"modelVersion": "<string>",
"source": "<string>"
},
"isBilled": true,
"invoicedDate": "2023-11-07T05:31:56Z",
"submissionDate": "2023-11-07T05:31:56Z",
"isManagedByChargeblast": true,
"isSubmittedEvidenceByChargeblast": true
},
"alerts": [
{
"id": "<string>",
"alertType": "<string>",
"creditAppealed": true,
"createdAt": "2023-11-07T05:31:56Z",
"amount": 123,
"transactionDate": "2023-11-07T05:31:56Z",
"subprovider": "<string>",
"provider": "<string>",
"card": "<string>",
"issuer": "<string>",
"invoicedAt": "2023-11-07T05:31:56Z",
"authCode": "<string>",
"site": "<string>",
"customerEmail": "<string>",
"creditStatus": "<string>",
"currency": "<string>",
"reasonCode": "<string>",
"merchantId": "<string>",
"acquirerAction": "<string>",
"alertId": "<string>",
"resolvedDate": "2023-11-07T05:31:56Z",
"resolvedByApi": true,
"externalOrder": "<string>",
"externalUrl": "<string>",
"creditNotes": "<string>",
"arn": "<string>",
"attributes": {
"order_number": "#1533",
"processor_id": "proc_b381c83a9bc8a93"
},
"customerId": "<string>",
"descriptor": "<string>",
"cardBrand": "<string>",
"responseAction": "<string>"
}
],
"deflections": [
{
"chargeId": "<string>",
"type": "<string>",
"network": "<string>",
"status": "<string>",
"amount_usd": 123,
"currency": "<string>",
"deflectionDate": "2023-11-07T05:31:56Z"
}
],
"submissions": [
{
"isBilled": true,
"isManual": true,
"evidence": [
{
"isSubmittedToProcessor": true,
"url": "<string>",
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"submittedByAccountId": "<string>"
}
],
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"disputeEnrichedId": "<string>",
"commonDisputeDirectId": "<string>"
}
]
}
],
"page": 123,
"per": 123,
"total": 123
}Disputes
Fetch Disputes
Get all the chargeback disputes from your Chargeblast account.
GET
/
api
/
v2
/
disputes
Fetch Disputes
curl --request GET \
--url https://api.chargeblast.com/api/v2/disputes \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://api.chargeblast.com/api/v2/disputes"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://api.chargeblast.com/api/v2/disputes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.chargeblast.com/api/v2/disputes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.chargeblast.com/api/v2/disputes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.chargeblast.com/api/v2/disputes")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.chargeblast.com/api/v2/disputes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"disputes": [
{
"dispute": {
"transactionDate": "2023-11-07T05:31:56Z",
"disputeDate": "2023-11-07T05:31:56Z",
"amount": 123,
"source": "Stripe",
"chargeId": "<string>",
"brand": "mastercard",
"userId": "<string>",
"daysLeftToRespond": "<string>",
"supportsAutoRepresentment": true,
"id": "<string>",
"submittedEvidence": true,
"currency": "<string>",
"customer": "<string>",
"refunded": true,
"descriptor": "<string>",
"status": "succeeded",
"last4": "<string>",
"shop": "<string>",
"bin": "<string>",
"wallet": "apple_pay",
"accountId": "<string>",
"funding": "credit",
"createdAt": "2023-11-07T05:31:56Z",
"subscriptionId": "<string>",
"subAccountId": "<string>",
"disputeStatus": "needs_response",
"reason": "<string>",
"isRDR": true,
"riskScore": 123,
"issuer": "<string>",
"amountUSD": 123,
"customerEmail": "<string>",
"authorizationCode": "<string>",
"streamId": "<string>",
"arn": "<string>",
"is3DS": true,
"expirationDate": "2023-11-07T05:31:56Z",
"kind": "chargeback",
"explanation": "alert_not_handled",
"alertId": "<string>",
"externalUrl": "<string>",
"winLikelihood": {
"score": 123,
"computedAt": "2023-11-07T05:31:56Z",
"modelVersion": "<string>",
"source": "<string>"
},
"isBilled": true,
"invoicedDate": "2023-11-07T05:31:56Z",
"submissionDate": "2023-11-07T05:31:56Z",
"isManagedByChargeblast": true,
"isSubmittedEvidenceByChargeblast": true
},
"alerts": [
{
"id": "<string>",
"alertType": "<string>",
"creditAppealed": true,
"createdAt": "2023-11-07T05:31:56Z",
"amount": 123,
"transactionDate": "2023-11-07T05:31:56Z",
"subprovider": "<string>",
"provider": "<string>",
"card": "<string>",
"issuer": "<string>",
"invoicedAt": "2023-11-07T05:31:56Z",
"authCode": "<string>",
"site": "<string>",
"customerEmail": "<string>",
"creditStatus": "<string>",
"currency": "<string>",
"reasonCode": "<string>",
"merchantId": "<string>",
"acquirerAction": "<string>",
"alertId": "<string>",
"resolvedDate": "2023-11-07T05:31:56Z",
"resolvedByApi": true,
"externalOrder": "<string>",
"externalUrl": "<string>",
"creditNotes": "<string>",
"arn": "<string>",
"attributes": {
"order_number": "#1533",
"processor_id": "proc_b381c83a9bc8a93"
},
"customerId": "<string>",
"descriptor": "<string>",
"cardBrand": "<string>",
"responseAction": "<string>"
}
],
"deflections": [
{
"chargeId": "<string>",
"type": "<string>",
"network": "<string>",
"status": "<string>",
"amount_usd": 123,
"currency": "<string>",
"deflectionDate": "2023-11-07T05:31:56Z"
}
],
"submissions": [
{
"isBilled": true,
"isManual": true,
"evidence": [
{
"isSubmittedToProcessor": true,
"url": "<string>",
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"submittedByAccountId": "<string>"
}
],
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"disputeEnrichedId": "<string>",
"commonDisputeDirectId": "<string>"
}
]
}
],
"page": 123,
"per": 123,
"total": 123
}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
Your API key. Sent in the X-API-Key header.
Query Parameters
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 ISO8601 date (or date-only, e.g. 2026-06-01). Only return disputes opened on or after this date.
ISO8601 date (or date-only, e.g. 2026-06-01). Only return disputes opened on or before this date.
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.
The starting page of the request. Default value of 1.
How many objects to request per page. Default value of 10, capped at 100.
