ZeroBounce Logo

Docs

Language Icon
  • Sign In
  • Sign Up Free

Languages

ZeroBounce ImageGetting Started
ZeroBounce ImageEmail List Validation
ZeroBounce ImageA.I. Email Scoring
ZeroBounce ImageEmail Finder
ZeroBounce ImageDomain Search
ZeroBounce ImageActivity Data
ZeroBounce ImageMulti-file upload
ZeroBounce ImageIntegrations
ZeroBounce ImageUsage Reports
ZeroBounce ImageYour ZeroBounce Account
ZeroBounce ImageEmail Validation API
ZeroBounce ImageEmail Finder API
ZeroBounce ImageDomain Search API
ZeroBounce ImageBulk Domain Search API
ZeroBounce ImageDomain Search - Send File
ZeroBounce ImageDomain Search - File Status
ZeroBounce ImageDomain Search - Get File
ZeroBounce ImageDomain Search - Delete File
ZeroBounce ImageA.I. Scoring API
ZeroBounce ImageSend File
ZeroBounce ImageSuccess / Fail Response
ZeroBounce ImageFile Status
ZeroBounce ImageGet File
ZeroBounce ImageDelete File
ZeroBounce ImageSingle email scoring
ZeroBounce ImageActivity Data API
ZeroBounce ImageList Evaluator API
ZeroBounce ImageApi Dashboard
ZeroBounce ImageAPI Wrappers
ZeroBounce ImageAPI Migration
ZeroBounce ImageFAQ
ZeroBounce ImageSecuring Your Account
ZeroBounce ImageAbout ZeroBounce
ZeroBounce ImageDeliverability Tools
ZeroBounce ImageStatus Page
  • Email Validation Homepage
  • Separator
  • Docs
  • Separator
  • A.I. Scoring API
  • Separator
  • Send File
A.I. Scoring API

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.