NAV Navbar
Logo
shell

Introduction

The ZeroScore API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website’s client-side code). JSON is returned by all API responses, including errors, although our API libraries convert responses to appropriate language-specific objects.

Authentication

Authenticate your account when using the API by including your secret API key in the request. You can manage your API keys in the ZeroScore Dashboard. Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such GitHub, client-side code, and so forth.

Choose one of the following authentication methods. For in-house direct one-to-one merchants we recommend authenticating using basic access authentication (HTTP Basic Auth).

For multitenancy software such as e-commerce providers we recommend using OAuth 2.0 for API key exchange for a better customer experience.

HTTP Basic Access Auth

To authenticate via basic http auth, use this code:

$ curl "https://api.zeroscore.com/v1/merchants" \
   -u "private_BQokikJOvBiI2HlWgH4olfQ2:"

curl uses the -u flag to pass basic auth credentials (adding a colon after your API key prevents cURL from asking for a password).

or use

$ curl "https://api.zeroscore.com/v1/merchants" \
   -H "Authorization: Basic cHJpdmF0ZV9CUW9raWtKT3ZCaUkySGxXZ0g0b2xmUTI"

Authentication to the API is performed via HTTP Basic Access Authentication. Provide your API key as the basic auth username value. You do not need to provide a password. If you need to authenticate via bearer auth (e.g., for a cross-origin request) see Token Authentication

If you don’t use a client which can handle the HTTP Basic Access Authentication request for you, make sure you send the request as a header with the following format:

Authorization: Basic cHJpdmF0ZV9CUW9raWtKT3ZCaUkySGxXZ0g0b2xmUTI6

Example:

base64encode(‘username:password’) = base64 value to pass in the header

base64encode('private_BQokikJOvBiI2HlWgH4olfQ2:’) = cHJpdmF0ZV9CUW9raWtKT3ZCaUkySGxXZ0g0b2xmUTI6

In the above example the username and empty password are base64 encoded. Note the : sign after your private key in the above example.

Token Authentication

To authenticate via token, use this code:

$ curl "https://api.zeroscore.com/v1/orders" \
   -H "Authorization: private_BQokikJOvBiI2HlWgH4olfQ2"

If you need to authenticate via bearer auth (e.g., for a cross-origin request), use header "Authorization: private_BQokikJOvBiI2HlWgH4olfQ2" for your API calls.

Location Headers

All ZeroScore API actions that create a new resource will return a Location header with the precise URL at which the newly created resource can be found. This URL should be used in all interaction with the API regarding this resource. We recommend you to use this URL instead of constructing one yourself.

Metadata

You can store additional metadata with ZeroScore that will be returned whenever an order is read from ZeroScore. The data take two forms: two reference fields to be used to store your internal order reference, and general metadata fields on the order and on each order line that can be used to store arbitrary data.

The reference fields are meta_data_1 and meta_data_2 used to store the interal reference to the order and/or any order item.

Merchants API

The Merchants API is used to create and update an merchant with ZeroScore.

Create a new merchant

HTTP Request

https://api.zeroscore.com/v1/merchants

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

$ curl --request POST \
  --url https://api.zeroscore.com/v1/merchants \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' \
  --data '{
"mid":"12345",
"name":"Air Company Inc",
"country":"US",
"mcc":"1711",
"org_number":"1235678987",
"doing_business_as":"AirComp",
"address_line_1":"Kesogatan 1",
"address_line_2":"Suite 123",
"postal_code":"12345",
"city":"Los Angeles",
"phone":"1123456789",
"deep_scan":false
}'

The above command returns JSON structured like this:

{
  "merchant": {
    "id": "HtdVdXTDNgkJzNuKw4TK6LLJ",
    "reference": {
      "mid": "12345"
    },
    "org_number": "1235678987",
    "mcc": {
      "mcc": 1711,
      "name": "Air Conditioning Contractors – Sales and Installation",
      "is_high_risk": false,
      "require_registration": false
    },
    "name": "Air Company Inc",
    "doing_business_as": "AirComp",
    "address_line_1": "Kesogatan 1",
    "address_line_2": "Suite 123",
    "postal_code": "12345",
    "city": "Los Angeles",
    "phone": "1123456789",
    "country": "US",
    "settings": {
      "deep_scan": false
    },
    "updated_at": "2017-03-29T19:59:25.000Z"
  },
  "links": [
    {
      "href": "https://api.zeroscore.com/v1/merchants/HtdVdXTDNgkJzNuKw4TK6LLJ",
      "rel": "merchant.show"
    }
  ]
}

Request Parameters

Name Type Description
mid String Required Your Merchant ID of the merchant (registered with the card schemes).
name String Required Company name of the merchant.
meta_data_1 String Can be used to store arbitrary merchant data on the merchant
meta_data_2 String Can be used to store arbitrary merchant data on the merchant
country String Merchant’s country code. ISO 3166-1 Alpha-2 i.e: US,GB,DE,SE, etc
deep_scan Boolean Default: false. Indicates if scan down to 10,000 pages should be performed on this merchant. Default is down to 1,000 pages.
org_number String Merchant’s oficcial company number, VAT number or filing number
doing_business_as String Merchant’s trading name.
mcc String Merchant’s MCC code
address_line_1 String Merchant’s physical address (street)
address_line_2 String Merchant’s physical address, line 2 (suite, apt, floor etc)
postal_code String Merchant’s postal code or zipcode.
city String Merchant’s City
phone String Merchant’s Phone (only digits), ie: for +1 (555) 1234 15551234

Read-Only Response Parameters

Name Type Description
id String ZeroScore’s unique ID for this merchant, also known as :merchant_id
reference Object Reference object
reference ➔ mid String Your Merchant ID of the merchant.
reference ➔ meta_data_1 String Arbitrary merchant data
reference ➔ meta_data_2 String Arbitrary merchant data
mcc Object MCC object
mcc ➔ mcc String Merchant’s MCC code
mcc ➔ name String MCC Caption
mcc ➔ is_high_risk Boolean Indicates if MCC code is MasterCard classed as High Risk MCC code
mcc ➔ require_registration Boolean Indicates if MCC code is MasterCard classed as Require Merchant Registration
links Object Links object
links ➔ href String URL to access the relation
links ➔ rel String Relation category
links ➔ method String Method used to access the href

Add sales channels to a merchant

A sales channel is a mobile app or website url/domain that belongs to the merchant and shall be monitored for BRAM violations or Transaction Laundering.

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id/sales_channels

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

$ curl --request POST \
  --url https://api.zeroscore.com/v1/merchants/HtdVdXTDNgkJzNuKw4TK6LLJ/sales_channels \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' \
  --data '{
"sales_channel_type":1,
"location":"http://merchantshop.com",
"bram":true,
"tld":true,
"deep_scan":false,
"auto_discover_subdomains":true,
"bram_scan_frequency_days":7,
"tld_scan_frequency_days":5
}'

The above command returns JSON structured like this:

{
  "sales_channel": {
    "id": "q3awEmreLGHv6HtBcFidxFjU",
    "name": "merchantshop.com",
    "reference": {},
    "domain": {
      "name": "merchantshop.com",
      "last_update_visits": "2017-04-04T07:26:21.000Z",
      "last_update_referral_in": "2017-04-04T07:26:22.000Z",
      "last_update_referral_out": "2017-04-04T07:26:23.000Z",
      "last_update_categorization": "2017-04-04T07:26:24.000Z",
      "last_update_tld": null,
      "categorization": {
        "brand_damage": false,
        "malicious": false,
        "restricted": false,
        "mature_audiences": false,
        "illegal": false,
        "malware": false,
        "copyright_infringement": false,
        "extreme_violence": false,
        "pornography": false,
        "profane": false,
        "hate": false,
        "under_construction": false,
        "ugc": false,
        "incentivized": false
      },
      "created_at": "2017-03-08T21:03:25.000Z",
      "updated_at": "2017-04-04T07:26:24.000Z"
    },
    "last_scanned_start": null,
    "last_scanned_completed": null,
    "tlm_channel": null,
    "is_auto_discovered": null,
    "country": "IE",
    "country_name": "Ireland",
    "isp": null,
    "maxdepth": 1000,
    "crawl_time_ms": 0,
    "pages_crawled": 0,
    "auto_discover_subdomains": true,
    "tld": {
          "score": 0.012
        },
    "created_at": "2017-04-04T07:26:21.000Z",
    "updated_at": "2017-04-04T07:26:21.000Z"
  }
}

Request Parameters

Name Type Description
:merchant_id String Required ZeroScore’s unique ID for this merchant, also known as ID
sales_channel_type Integer Always 1. (unless instructed otherwise)
meta_data_1 String Can be used to store arbitrary data on the sales channel
meta_data_2 String Can be used to store arbitrary data on the sales channel
location String Required The URL of merchant’s website. (unless instructed otherwise)
bram Boolean Default: true. Indicates if BRAM scan shall be performed.
tld Boolean Default: false. Indicates if Transaction Laundring Detection shall be performed.
deep_scan Boolean Default: false. Indicates if scan down to 10,000 pages should be performed on this sales channel. Default is down to 1,000 pages.
auto_discover_subdomains Boolean Default: true. Indicates if subdomains to the top domain shall be auto-added as sales channels to the merchant.
bram_scan_frequency_days Integer Days between BRAM scans for this sales channel.
tld_scan_frequency_days Integer Days between TLD scans for this sales channel.

Read-Only Response Parameters

Name Type Description
:sales_channel_id String Required ZeroScore’s unique ID for this sales channel, also known as Sales Channel ID

Sales Channel Types

sales_channel_type Name location description
1 Website URL of the website.
2 Android App Not public available, only in private beta!
3 iOS App Not public available, only in private beta!
4 POS Not public available, only in private beta!
5 mPOS Not public available, only in private beta!
6 MOTO Not public available, only in private beta!
7 Other Not public available, only in private beta!

View an sales channel

HTTP Request

A sales channel is a mobile app or website url/domain that belongs to the merchant and shall be monitored for BRAM violations or Transaction Laundering.

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id/sales_channels/:sales_channel_id

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

You must replace UVWofp7AjHiRKNLjhUjMnhc3 with your order token (:id).

$ curl --request GET \
  --url https://api.zeroscore.com/v1/merchants/UVWofp7AjHiRKNLjhUjMnhc3/sales_channels/q3awEmreLGHv6HtBcFidxFjU \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' 

The above command returns JSON structured like this:

{
  "sales_channel": {
    "id": "q3awEmreLGHv6HtBcFidxFjU",
    "name": "merchantshop.com",
    "reference": {},
    "domain": {
      "name": "merchantshop.com",
      "last_update_visits": "2017-04-04T07:26:21.000Z",
      "last_update_referral_in": "2017-04-04T07:26:22.000Z",
      "last_update_referral_out": "2017-04-04T07:26:23.000Z",
      "last_update_categorization": "2017-04-04T07:26:24.000Z",
      "last_update_tld": null,
      "categorization": {
        "brand_damage": false,
        "malicious": false,
        "restricted": false,
        "mature_audiences": false,
        "illegal": false,
        "malware": false,
        "copyright_infringement": false,
        "extreme_violence": false,
        "pornography": false,
        "profane": false,
        "hate": false,
        "under_construction": false,
        "ugc": false,
        "incentivized": false
      },
      "created_at": "2017-03-08T21:03:25.000Z",
      "updated_at": "2017-04-04T07:26:24.000Z"
    },
    "last_scanned_start": null,
    "last_scanned_completed": null,
    "tlm_channel": null,
    "is_auto_discovered": null,
    "country": "IE",
    "country_name": "Ireland",
    "isp": null,
    "maxdepth": 1000,
    "crawl_time_ms": 0,
    "pages_crawled": 0,
    "auto_discover_subdomains": true,
    "tld": {
          "score": 0.012
        },
    "created_at": "2017-04-04T07:26:21.000Z",
    "updated_at": "2017-04-04T07:26:21.000Z"
  }
}

Request Parameters

Name Type Description
:sales_channel_id String Required ZeroScore’s unique ID for this sales channel, also known as Sales Channel ID

Read-Only Response Parameters

Name Type Description

View an merchant

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

You must replace UVWofp7AjHiRKNLjhUjMnhc3 with your order token (:id).

$ curl --request GET \
  --url https://api.zeroscore.com/v1/merchants/UVWofp7AjHiRKNLjhUjMnhc3 \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' 

The above command returns JSON structured like this:

{
  "merchant": {
    "id": "HtdVdXTDNgkJzNuKw4TK6LLJ",
    "reference": {
      "mid": "12345"
    },
    "org_number": "1235678987",
    "mcc": {
      "mcc": 1711,
      "name": "Air Conditioning Contractors – Sales and Installation",
      "is_high_risk": false,
      "require_registration": false
    },
    "name": "Air Company Inc",
    "doing_business_as": "AirComp",
    "address_line_1": "Kesogatan 1",
    "address_line_2": "Suite 123",
    "postal_code": "12345",
    "city": "Los Angeles",
    "phone": "1123456789",
    "country": "US",
    "settings": {
      "deep_scan": false
    },
    "updated_at": "2017-03-29T19:59:25.000Z"
  },
  "links": [
    {
      "href": "https://api.zeroscore.com/v1/merchants/HtdVdXTDNgkJzNuKw4TK6LLJ",
      "rel": "merchant.show"
    }
  ]
}

Request Parameters

Name Type Description
:merchant_id String Required ZeroScore’s unique ID for this merchant, also known as ID

Read-Only Response Parameters

Name Type Description

Update a merchant

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

$ curl --request PATCH \
  --url https://api.zeroscore.com/v1/merchants/UVWofp7AjHiRKNLjhUjMnhc3 \
  --header 'accept: application/json' \
  --header 'Authorization: private_9xxJrsc1u2TF6cPCm6JzG2ry' \
  --header 'content-type: application/json' \
  --data '{
"mid":"12345",
"name":"Air Company Inc",
"country":"US",
"mcc":"1711",
"org_number":"1235678987",
"doing_business_as":"AirComp",
"address_line_1":"Kesogatan 1",
"address_line_2":"Suite 123",
"postal_code":"12345",
"city":"Los Angeles",
"phone":"1123456789",
"deep_scan":false
}'

The above command returns JSON structured like this:

{
  "merchant": {
    "id": "HtdVdXTDNgkJzNuKw4TK6LLJ",
    "reference": {
      "mid": "12345"
    },
    "org_number": "1235678987",
    "mcc": {
      "mcc": 1711,
      "name": "Air Conditioning Contractors – Sales and Installation",
      "is_high_risk": false,
      "require_registration": false
    },
    "name": "Air Company Inc",
    "doing_business_as": "AirComp",
    "address_line_1": "Kesogatan 1",
    "address_line_2": "Suite 123",
    "postal_code": "12345",
    "city": "Los Angeles",
    "phone": "1123456789",
    "country": "US",
    "settings": {
      "deep_scan": false
    },
    "updated_at": "2017-03-29T19:59:25.000Z"
  },
  "links": [
    {
      "href": "https://api.zeroscore.com/v1/merchants/HtdVdXTDNgkJzNuKw4TK6LLJ",
      "rel": "merchant.show"
    }
  ]
}

Request Parameters

Request Parameters

Name Type Description
:merchant_id String Required ZeroScore’s unique ID for this merchant, also known as ID
mid String Required Your Merchant ID of the merchant (registered with the card schemes).
name String Required Company name of the merchant.
meta_data_1 String Can be used to store arbitrary merchant data on the merchant
meta_data_2 String Can be used to store arbitrary merchant data on the merchant
country String Merchant’s country code. ISO 3166-1 Alpha-2 i.e: US,GB,DE,SE, etc
deep_scan Boolean Default: false. Indicates if scan down to 10,000 pages should be performed on this merchant. Default is down to 1,000 pages.
org_number String Merchant’s oficcial company number, VAT number or filing number
doing_business_as String Merchant’s trading name.
mcc String Merchant’s MCC code
address_line_1 String Merchant’s physical address (street)
address_line_2 String Merchant’s physical address, line 2 (suite, apt, floor etc)
postal_code String Merchant’s postal code or zipcode.
city String Merchant’s City
phone String Merchant’s Phone (only digits), ie: for +1 (555) 1234 15551234

Read-Only Response Parameters

Name Type Description
id String ZeroScore’s unique ID for this merchant, also known as :merchant_id
reference Object Reference object
reference ➔ mid String Your Merchant ID of the merchant.
reference ➔ meta_data_1 String Arbitrary merchant data
reference ➔ meta_data_2 String Arbitrary merchant data
mcc Object MCC object
mcc ➔ mcc String Merchant’s MCC code
mcc ➔ name String MCC Caption
mcc ➔ is_high_risk Boolean Indicates if MCC code is MasterCard classed as High Risk MCC code
mcc ➔ require_registration Boolean Indicates if MCC code is MasterCard classed as Require Merchant Registration
links Object Links object
links ➔ href String URL to access the relation
links ➔ rel String Relation category
links ➔ method String Method used to access the href

Delete a sales channel

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id/sales_channels/:sales_channel_id

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

You must replace q3awEmreLGHv6HtBcFidxFjU with your sales channel id.

$ curl --request DELETE \
  --url https://api.zeroscore.com/v1/merchants/UVWofp7AjHiRKNLjhUjMnhc3/sales_channels/q3awEmreLGHv6HtBcFidxFjU \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' 

The above command returns JSON structured like this:

{"successful":"true"}

Request Parameters

Name Type Description
:sales_channel_id String Required ZeroScore’s unique ID for this sales channel, also known as Sales Channel ID

Read-Only Response Parameters

Name Type Description

Delete a merchant

HTTP Request

https://api.zeroscore.com/v1/merchants/:merchant_id

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

You must replace UVWofp7AjHiRKNLjhUjMnhc3 with the merchant id.

$ curl --request DELETE \
  --url https://api.zeroscore.com/v1/merchants/UVWofp7AjHiRKNLjhUjMnhc3 \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' 

The above command returns JSON structured like this:

{"successful":"true"}

Request Parameters

Name Type Description
:merchant_id String Required ZeroScore’s unique ID for this merchant, also known as ID

Read-Only Response Parameters

Name Type Description
id String ZeroScore’s unique ID for this merchant, also known as :merchant_id

Violations API

The Violations API is used to view current violations found by ZeroScore.

View current violations

HTTP Request

https://api.zeroscore.com/v1/violations

You must replace private_BQokikJOvBiI2HlWgH4olfQ2 with your private API key.

$ curl --request GET \
  --url https://api.zeroscore.com/v1/violations \
  --header 'accept: application/json' \
  --header 'Authorization: private_BQokikJOvBiI2HlWgH4olfQ2' \
  --header 'content-type: application/json' 

The above command returns JSON structured like this:

{
  "violations": [
  {
    "id": "UVWofp7AjHiRKNLjhUjMnhc3",
    "url": "http://merchant.com",
    "keyword": {
      "data": "porn",
      "keyword_category": {
        "id": 9,
        "name": "Adult",
        "bram_report_visa": false,
        "bram_report_mc": false,
        "global_list": true,
        "list_name": "forbidden_words"
      },
      "is_regexp": false
    },
    "sales_channel": {
      "id": "UVWofp7AjHiRKNLjh234555",
      "name": "merchant.com",
      "reference": {},
      "domain": {
        "name": "merchant.com",
        "last_update_visits": "2017-04-04T07:26:21.000Z",
        "last_update_referral_in": "2017-04-04T07:26:22.000Z",
        "last_update_referral_out": "2017-04-04T07:26:23.000Z",
        "last_update_categorization": "2017-04-04T07:26:24.000Z",
        "last_update_tld": null,
        "categorization": {
          "brand_damage": false,
          "malicious": false,
          "restricted": false,
          "mature_audiences": false,
          "illegal": false,
          "malware": false,
          "copyright_infringement": false,
          "extreme_violence": false,
          "pornography": false,
          "profane": false,
          "hate": false,
          "under_construction": false,
          "ugc": false,
          "incentivized": false
        },
        "created_at": "2017-03-08T21:03:25.000Z",
        "updated_at": "2017-04-04T07:26:24.000Z"
      },
      "last_scanned_start": "2017-03-08T21:09:30.000Z",
      "last_scanned_completed": "2017-03-08T21:10:05.000Z",
      "tlm_channel": null,
      "is_auto_discovered": null,
      "country": "IE",
      "country_name": "Ireland",
      "isp": null,
      "maxdepth": 1000,
      "crawl_time_ms": 35597,
      "pages_crawled": 119,
      "auto_discover_subdomains": true,
      "tld": {
          "score": 0.012
        },
      "created_at": "2017-03-08T21:03:25.000Z",
      "updated_at": "2017-03-08T21:10:05.000Z"
    },
    "merchant": {
      "id": "UVWofp7AjHiRKNLjhUjMnhc3",
      "reference": {
        "mid": ""
      },
      "org_number": null,
      "mcc": null,
      "name": "Merchant Inc",
      "doing_business_as": null,
      "address_line_1": null,
      "address_line_2": null,
      "postal_code": null,
      "city": null,
      "phone": null,
      "country": null,
      "settings": {
        "deep_scan": false
      },
      "updated_at": "2017-03-08T21:03:18.000Z"
    },
    "violation_category": null,
    "flagged": false,
    "investigation_status": null,
    "reported": false,
    "bram_report_id": null
  }
]}

Read-Only Response Parameters

Name Type Description
id String ZeroScore’s unique ID for this merchant, also known as :merchant_id
reference Object Reference object
reference ➔ mid String Your Merchant ID of the merchant.
reference ➔ meta_data_1 String Arbitrary merchant data
reference ➔ meta_data_2 String Arbitrary merchant data
mcc Object MCC object
mcc ➔ mcc String Merchant’s MCC code
mcc ➔ name String MCC Caption
mcc ➔ is_high_risk Boolean Indicates if MCC code is MasterCard classed as High Risk MCC code
mcc ➔ require_registration Boolean Indicates if MCC code is MasterCard classed as Require Merchant Registration
links Object Links object
links ➔ href String URL to access the relation
links ➔ rel String Relation category
links ➔ method String Method used to access the href

Response and Error Codes

HTTP status code summary (not limited to):

ZeroScore uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.), and codes in the 5xx range indicate an error with ZeroScore’s servers (these are rare).

HTTP Code Successful Meaning
200 Yes OK - Your request was sucessful
201 Yes Created - Your request was created
202 Yes Accepted - Your request was accepted and item was updated
400 No Bad Request – Your request has invalid data. Check your parameters.
401 No Unauthorized – Your API key is wrong, see Authentication
402 No Account limit reached. Contact your account manager to increase your API plan.
403 No Forbidden – The requested data is restricted for your api key.
404 No Not Found – The requested data is not found.
406 No Not Acceptable – You requested a format that isn’t json
429 No Too Many Requests – Your code is pounding our servers, to protect us from evil loops we have a request limit. Should you discover that you need to raise your limit, please contact support.
5XX No Something went wrong on ZeroScore’s end. (These are rare.)