AI 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

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.