This API will tell you how many credits you have left on your account. It's simple, fast and easy to use.
Here are a few scenarios in which businesses should use this API:
- When using our API to validate emails, periodically check your credit balance to avoid service interruptions caused by insufficient credits.
- Track how many email validation credits you're using per your defined time frame to generate useful statistical information.
- Automate and integrate information into your application dashboard that shows you your current remaining credit balance.
Below, you will find the instructions on how to use our API. It's very easy to use, and it requires SSL.
GET /V2/GETCREDITS
API DEFAULT URL: https://api.zerobounce.net/v2/getcredits
API U.S.A. URL*: https://api-us.zerobounce.net/v2/getcredits
API EU URL: https://api-eu.zerobounce.net/v2/getcredits
*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.
Below you will find the instructions on how to use our API. It's very easy to use and requires SSL. The API requires an active credit balance and will never consume a credit for any unknown result.
URL Parameters
- ParameterDescription
- api_keyYour API Key, found in your account.
GET CREDIT BALANCE CODE SAMPLES
This API will tell you how many credits you have left on your account. It's simple, fast and easy to use.
If you want to call the API from your browser to test it, all you have to do is replace the API KEY with your key:
API DEFAULT URL: https://api.zerobounce.net/v2/getcredits?api_key=[replacewithyours]
API U.S.A. URL*: https://api-us.zerobounce.net/v2/getcredits?api_key=[replacewithyours]
API EU URL: https://api-eu.zerobounce.net/v2/getcredits?api_key=[replacewithyours]
This API will tell you how many credits you have left on your account.
The API will return these results in a JSON format using the "getcredits" method. ‘Credits’ is the value that shows the number of credits left in your account for email validations. If a -1 is returned, that means your API Key is invalid.
*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.
ENDPOINT RESPONSE
This API will tell you how many credits you have left on your account. It's simple, fast and easy to use.
Successful Response
{"Credits":2375323}
{"Credits":-1}
GetCredits V2 Rate Limits
We allow a maximum of 50,000 requests in 1 hour before temporarily blocking for 1 day for the following endpoints:
- https://api.zerobounce.net/v2/getcredits
- https://api-us.zerobounce.net/v2/getcredits*
- https://api-eu.zerobounce.net/v2/getcredits
Bad API key requests (200 times in 1 hour) to the following endpoints will result in a temporary block for 1 day:
- https://api.zerobounce.net/v2/getcredits
- https://api-us.zerobounce.net/v2/getcredits*
- https://api-eu.zerobounce.net/v2/getcredits
*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.