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.