REST API
The Bad Customer API is easy to use, and you can choose between XML or JSON response output.
You can query a customer by submitting their name, email, street address, and the range (the number of days back you want to look, up to one year) and we'll show you what we have on them.
Looking up a customer
<?xml version="1.0"?>
<badcustomer>
<range_days>90</range_days>
<chargebacks_found>3</chargebacks_found>
<chargebacks_total>307.27</chargebacks_total>
<chargebacks>
<chargeback>
<date>12/2/2024</date>
<amount>41.23</amount>
</chargeback>
<chargeback>
<date>11/7/2024</date>
<amount>184.90</amount>
</chargeback>
<chargeback>
<date>10/20/2024</date>
<amount>81.14</amount>
</chargeback>
</chargebacks>
</badcustomer>
{badcustomer": {
"range_days": "90",
"chargebacks_found": "3",
"chargebacks_total": "307.27",
"chargebacks": {
"chargeback": [
{
"date": "12/2/2024",
"amount": "41.23"
},
{
"date": "11/7/2024",
"amount": "184.90"
},
{
"date": "10/20/2024",
"amount": "81.14"
}
]
}
}}
Customer opt-out rights
Sometimes customers request to have their data removed from our system. When this happens, we return -1 for both the chargebacks_found and chargebacks_total fields, and include the optout_notice response.
<?xml version="1.0"?>
<badcustomer>
<range_days>90</range_days>
<chargebacks_found>-1</chargebacks_found>
<chargebacks_total>-1</chargebacks_total>
<optout_notice>Customer requested removal</optout_notice>
</badcustomer>
{badcustomer": {
"range_days": "90",
"chargebacks_found": "-1",
"chargebacks_total": "-1",
"optout_notice": "Customer requested removal"
}
}
Learn
Take Action
Join the Fight
Our mission is simple: we want to stop customers who steal from sellers. As a participating seller, your chargeback data is helping other sellers avoid bad customers, just like how the data they submit is helping you. Sign up for free and join the fight.