Ready to use our bulk email scoring API?
The scoring sendfile API allows you to send a file for bulk email scoring. The content type needs to be multipart/form-data. Please refer to the C# example for details.
POST /V2/SCORING/SENDFILE
API URL: https://bulkapi.zerobounce.net/v2/scoring/sendfile
Below you will see a list of the required parameters. Please gather this data in the right format before you proceed.
- Your file needs to have a .csv or .txt format.
- Next, you’ll need your unique API key which you can find in your ZeroBounce account.
URL Parameters
- ParameterRequired / OptionalDescription
- fileRequiredThe csv or txt file. Byte array contents for the submitted file. The content's header is type of "text/csv"
- api_keyRequiredYour API Key, found in your account
- email_address_columnRequiredThe column index of the email address in the file. Index starts at 1
- return_urlRequiredThe URL will be used as a callback when the scoring service is completed
- has_header_rowRequiredIf the first row from the submitted file is a header row. True or False
- remove_duplicateOptionalIf you want the system to remove duplicate emails (true or false, default is true). Please note that if we remove more than 50% of the lines because of duplicates (parameter is true), system will return a 400 bad request error as a safety net to let you know that more than 50% of the file has been modified.
{
"file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
"file_name": "Your file name.csv",
"upload_date": "2023-04-28T15:25:41Z"
}
SEND FILE CODE SAMPLES
ENDPOINT RESPONSE
Here we provide you with examples of both successful and error responses for the bulk email scoring API.
Successful Response
{
"success": true,
"message": "File Accepted",
"file_name": "Your file name.csv",
"file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff"
}
{
"success": false,
"message": [
"Error messages"
]
}
Do you have any questions or need help getting started with the ZeroBounce bulk email scoring API? Please get in touch with our team. Our Customer Support specialists are available 24/7 to guide you and help clarify potential issues.
The email scoring API can be used both in bulk and in real time.