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

Query https://[apiurl]/?range=90&format=[xml|json]&firstname=[firstname]&lastname=[lastname]&email=[email]&address1=[address1]&address=[address2]&zipcode=[zipcode]&countrycode=[countrycode]

XML Response


<?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/18/2024</date>
         <amount>41.23</amount>
      </chargeback>
      <chargeback>
         <date>11/23/2024</date>
         <amount>184.90</amount>
      </chargeback>
      <chargeback>
         <date>11/5/2024</date>
         <amount>81.14</amount>
      </chargeback>
   </chargebacks>
</badcustomer>

JSON Response


{badcustomer": {
   "range_days": "90",
   "chargebacks_found": "3",
   "chargebacks_total": "307.27",
   "chargebacks": {
      "chargeback": [
         {
            "date": "12/18/2024",
            "amount": "41.23"
         },
         {
            "date": "11/23/2024",
            "amount": "184.90"
         },
         {
            "date": "11/5/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 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>

JSON Response


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