A.I. Scoring API

Send File

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

Parameter
Required / Optional
Description

file
Required
The csv or txt file. Byte array contents for the submitted file. The content's header is type of "text/csv"
api_key
Required
Your API Key, found in your account
email_address_column
Required
The column index of the email address in the file. Index starts at 1
return_url
Required
The URL will be used as a callback when the scoring service is completed
has_header_row
Required
If the first row from the submitted file is a header row. True or False
remove_duplicate
Optional
If 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.

If a return_url was specified in the Multipart Form Data during the send file request, we will POST the following data to the URL when the validation process is complete.


    {

        "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
        "file_name": "Your file name.csv",
        "upload_date": "2023-04-28T15:25:41Z" 
   
    }

SEND FILE CODE SAMPLES

Send File

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"
    }

Error Response


    {
        "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.