Validity BriteVerify's RESTful webservice APIs are designed to cater to single-verification requests as well as bulk verification requests. Our verification APIs support global email addresses, US and Canada phone numbers, and US physical addresses.
To ensure the most accurate results and efficient utilization, it's important to know which API should be used and the respective limits of both before getting started.
Transactional Verification: The single-verification API is ideal for integrating point-of-capture data verification into your own applications. Email, Phone and Address verification API should be used in response to an action, like a form submission or button click. It should NOT be used for verifying emails, phone or addresses in an existing list or database one-by-one. So for that purpose, you may utilize the Bulk API.
Bulk Verification: The bulk endpoint provides high-speed verification for a list of email, phone and/or physical addresses. You can also use the endpoint to poll current status for an existing list job. Once the list job has completed, the results can be downloaded in various supported formats.
Bulk API should be used to verify databases or lists of several emails, phones and/or US addresses. You should submit all the data you have for verification in a single list job rather than multiple list jobs. It is better to submit a single list job of 10k records or more. The maximum volume is 1 million records per list job.
If you're collecting data from external sources like a CRM or MAP for verification, you should buffer the data locally and submit it as a single job rather than submitting each chunk of data separately. Do NOT create more than 10 concurrent list jobs for processing. Sending too many small jobs in a short amount of time can result in your account being disabled.
This page describes how to authenticate with BriteVerify APIs. All requests must be authenticated using the account specific back-end key.
To view your back-end key, log in to your account and go to the API Keys tab.
API keys are sensitive and give access to the data in your account as well as access to verify data. Only trusted sources should be given access to these keys to protect your account. If you suspect your key is compromised, contact our support team immediately for assistance.
Understand your results by reviewing email, phone and address API status key. This allows you to make actionable decisions based on the valuable results provided by the API.
Each of your API request is reported by parameter in the Dashboard report under the API, Full Verify API, or Bulk API dropdown options. To see your usage, login to your account and click on the Usage tab. All reporting is available in customizable date range based on UTC.
API Credit Utilization
Validity BriteVerify will utilize a credit for each address, phone or email verified. If the request contains just a single parameter, only a single credit would be utilized. Alternatively, for all three parameters, three credits will be consumed.