API DASHBOARD

API Endpoints

API Endpoints

Currently, ZeroBounce uses three different endpoints for use with our various API services. These endpoints include the following:

  • api-us.zerobounce.net - This is an endpoint where validations and other interactions only occur within the United States.
  • api-eu.zerobounce.net - This is an endpoint where validations and other interactions only occur within the European Union (EU).
  • api.zerobounce.net - The previous ZeroBounce endpoint; this URL is currently only used for validations and interactions within the EU. If and when any updates are made to this endpoint, we’ll notify our users and update our documentation accordingly.

ZeroBounce currently operates from the following locations:

  • EU - Frankfurt, Germany
  • US - New York City, New York

We recommend using the endpoint that’s closest to your location for optimal processing speeds. Additionally, consider the international privacy and compliance requirements to which your business is subject, based on where you obtain, store, and process your data.

API Rate Limits

API Rate Limiting

Rate limits are in place to protect our customers and the platform while allowing us to provide you with the best accuracy and validation speed. While it’s not our intention, going over these limits may result in a temporary block. As such, we recommend that our customers and partners adhere to best practices and stay within these limits.

General rate limits

Bad requests to any endpoint (as an example, not including the email parameter in an API call) 100 times in 1 minute will result in a temporary block for 1 hour.

Requests to non-existent pages or endpoints 100 times in 2 minutes will result in a temporary block for 1 hour.

GetCredits V2

We allow a maximum of 50,000 requests per hour for the following endpoints:

  • api.zerobounce.net/v2/getcredits
  • api-us.zerobounce.net/v2/getcredits*
  • api-eu.zerobounce.net/v2/getcredits

Exceeding this limit results in a temporary block for 1 day.

Bad API key requests (200 times in 1 hour) to the following endpoints will result in a temporary block for 1 day:

  • api.zerobounce.net/v2/getcredits
  • api-us.zerobounce.net/v2/getcredits
  • api-eu.zerobounce.net/v2/getcredits

API Validation V2

We allow a maximum of 50,000 requests in 10 seconds (validations) for the following endpoints:

  • api.zerobounce.net/v2/validate
  • api-us.zerobounce.net/v2/validate*
  • api-eu.zerobounce.net/v2/validate

Exceeding this limit results in a temporary block for 1 minute.

Bad API key requests (200 times in 1 hour) to the following endpoints will result in a temporary block for 1 hour:

  • api.zerobounce.net/v2/validate
  • api-us.zerobounce.net/v2/validate*
  • api-eu.zerobounce.net/v2/validate

GetApiUsage V2

Bad requests (200 times in 1 hour) to the following endpoints will result in a temporary block for 1 hour:

  • api.zerobounce.net/v2/getapiusage
  • api-us.zerobounce.net/v2/getapiusage*
  • api-eu.zerobounce.net/v2/getapiusage

BulkAPI and BulkAPI Batch Validate

We allow a maximum of (250 requests in 1 minute) for the bulkapi.zerobounce.net/ before temporarily blocking for 1 hour.

We allow a maximum of (20 requests in 1 minute) for the bulkapi.zerobounce.net/v2/validatebatch before temporarily blocking for 10 minutes.

Bad requests to bulkapi.zerobounce.net (200 times in 1 hour) will result in a temporary block for 1 hour.

BulkAPI Unknown

Batch responses to bulkapi.zerobounce.net/v2/validate that contains over 20 unknown statuses (that are neither greylisted nor antispam) more than once per hour will temporarily block for 1 hour.

Activity V2

Bad API key requests (200 times in 1 hour)to the following endpoints will result in a temporary block for 1 hour:

  • api.zerobounce.net/v2/activity
  • api-us.zerobounce.net/v2/activity*
  • api-eu.zerobounce.net/v2/activity

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.