Upload a bulk email list

POST https://api.bouncify.io/v1/bulk

This endpoint allows you to upload a bulk email validation list. It accepts the email data in multiple ways. You can upload email addresses in the CSV file format or an array of objects.

If auto_verify is enabled, this API will create a job and automatically process each email in the uploaded list. If the auto_verify is disabled, the email list is prepared and ‘ready’ for verification, you can start verification using start endpoint. The API response does not contain the verification results. Instead it returns the job_id in the success response. Once the verification is completed, you can download the result using this job_id.

Option 1: CSV file

This endpoint accepts the file in .csv (comma separated values) format. The supported size of the file is 10Mb. The number of emails in a file must be within 5 lakhs. The additional columns in the csv file will be retained.

Option 2: Array of emails

Instead of having to write to a file, you can dynamically create email lists on the fly when you provide the data directly. The array of objects contains the ‘email’ field as well as any additional data you want to include with the email. If the data is provided as an object, the key names will be used for the column headers. Here is an example of an email object in JSON format.

Emails Object

{
    "auto_verify": "true",
    "emails": [
        {
            "email": "test1@example.com",
            "firstname": "John",
            "lastname": "Doe"
        },
        {
            "email": "test2@example.com",
            "firstname": "Daniel",
            "lastname": "Jay"
        }
    ]
}

Limits

Our API supports having up to 500 unverified lists in an account, with a maximum of 100 lists allowed for active verification concurrently.

Request Parameters

Parameter	Type	Required	Description
apikey	string	Required	Your API key
local_file	file	Required	The file to be upload in .csv format
auto_verify	boolean	Optional	Auto verify allows to start verification instantly. Defaults to false.
RAW_BODY	json	Required	The emails to be verified

Successful Response

JSON

HTTP/1.1 200 OK
{
   "job_id": "r374aki32rnatv868nntpxloc7dkilszc3eu",
   "success": true,
      "message": "Bulk email verification list has been created"
}

Response Parameters

Parameter	Type	Description
job_id	string	The job_id corresponding to the list you have been created
success	[true, false]	Whether the API request call was successful or not.
message	string	Describes API result

Other responses

The response you get when the API key is invalid:

HTTP/1.1 401 Unauthorized
{
      "result":"Invalid API Key",
   "success": false
}

The response you get when the auto_verify is enabled:

HTTP/1.1 200 OK
{
   "job_id": "r374aki32rnatv868nntpxloc7dkilszc3eu",
   "success": true,
      "message": "Bulk email verification list has been created and starts verification shortly"
}

The response you get when you provide the incorrect file format:

HTTP/1.1 400 BadRequest
{
   "result": "Invalid file data",
   "success": false
}

The response you get when you reach the limit of maximum list uploads.

HTTP/1.1 400 BadRequest
{
    "success": false,
    "message": "The maximum number of lists has been reached."
}

The response you get when you reach the limit of concurrent list verifications.

HTTP/1.1 400 BadRequest
{
    "success": false,
    "message": "The maximum number of active verification lists has been reached."
}

Example

Python / PHP / Node / Ruby / Shell

curl --request POST \
     --url https://api.bouncify.io/v1/bulk \
     --header 'accept: application/json' \
     --header 'content-type: application/json'