Email Verify

The Email Verify API lets you validate email addresses in real time or in bulk before sending, so you can reduce bounces, protect sender reputation, and keep your contact database clean across all your GTM workflows.

Instant Verify

post

Instant verification API can be seamlessly integrated into your signup or onboarding process with just a single request. Use this API to verify Email Address without going through queue

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutinteger · max: 180000Optional

Request wait time (in milliseconds), Maximum allowed wait time should not exceed 180,000 milliseconds

Default: 130000Example: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

429

Too Many Requests

application/json

503

Service Unavailable

524

A Timeout Occurred

application/json

post

/email_verify/instant

HTTPcURLJavaScriptPython

POST /v2/email_verify/instant HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "safe_to_send": "yes",
    "status": "valid",
    "verified_on": "2019-05-02T18:12:53+05:30",
    "time_taken": 432,
    "sub_status": {
      "code": 200,
      "desc": "Success"
    },
    "detail_info": {
      "account": "us",
      "domain": "clearout.io"
    },
    "disposable": "no",
    "free": "no",
    "role": "yes",
    "gibberish": "no",
    "suggested_email_address": "text",
    "profile": null,
    "bounce_type": "text"
  }
}

Bulk Verify

post

Use bulk verify to upload your contact lists, request will be put on queue and at any point you can check the status of your request using Bulk Verify Progress Status API

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

filestring · base64Required

optimizestringOptional

Can be either 'highest_accuracy' or 'fastest_turnaround'

Default: highest_accuracyExample: fastest_turnaround

ignore_duplicate_filestringOptional

Whether to allow file with the same name and size that match with your recent upload

Default: falseExample: true

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email_verify/bulk

HTTPcURLJavaScriptPython

POST /v2/email_verify/bulk HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 76

{
  "file": "text",
  "optimize": "fastest_turnaround",
  "ignore_duplicate_file": true
}

{
  "status": "success",
  "data": {
    "list_id": "5c60eb454506101c9d2f7b17"
  }
}

Bulk Verify Progress Status

get

To know the overall progress status of bulk verify request

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

list_idstringRequired

Pass the value of bulk verify list_id property from response object

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

401

Unauthorized

application/json

503

Service Unavailable

get

/email_verify/bulk/progress_status

HTTPcURLJavaScriptPython

GET /v2/email_verify/bulk/progress_status?list_id=text HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "progress_status": "completed",
    "percentile": 100
  }
}

Bulk Verify Result Download

post

Bulk verify result download

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/download/result

HTTPcURLJavaScriptPython

POST /v2/download/result HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb"
}

{
  "status": "success",
  "data": {
    "url": "https://clearout.s3.ap-south-1.amazonaws.com/5c6810bb82e2fc4ab21ce233/5c681d56cc56176d10d78f31/results/test3_clearout_results.csv"
  }
}

Bulk Verify Result Removal

post

Bulk verify result removal

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

ignore_resultbooleanOptional

Set this value to true when download request is in progress, otherwise list removal will be denied

Default: falseExample: true

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email_verify/list/remove

HTTPcURLJavaScriptPython

POST /v2/email_verify/list/remove HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb",
  "ignore_result": true
}

{
  "status": "success",
  "data": {
    "name": "email_verify.xlsx",
    "source": "upload",
    "created_on": "2022-05-16 10:41:30.427Z"
  }
}

Bulk Verify Cancel

post

Cancel running bulk verify contact list

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

503

Service Unavailable

post

/email_verify/list/cancel

HTTPcURLJavaScriptPython

POST /v2/email_verify/list/cancel HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb"
}

{
  "status": "success",
  "data": {
    "name": "email_verify.xlsx",
    "source": "upload",
    "created_on": "2022-05-16 10:41:30.427Z"
  }
}

Catch-All Verify

post

Verify email address for Catch-All, since certain servers accept all the emails for that domain and never bounces it back to the sender, those email addresses are flagged as catch-all emails

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

524

A Timeout Occurred

application/json

post

/email/verify/catchall

HTTPcURLJavaScriptPython

POST /v2/email/verify/catchall HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "catchall": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Disposable Account Verify

post

Verify email address for Disposable, generally these email addresses live for short period of time and used for account activation or confirmation emails for sites like forums, e-shopping etc. so it is highly recommended not to send email to disposable addresses

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email/verify/disposable

HTTPcURLJavaScriptPython

POST /v2/email/verify/disposable HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "catchall": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Business Account Verify

post

Verify email address belongs to business (a.k.a work) account

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email/verify/business

HTTPcURLJavaScriptPython

POST /v2/email/verify/business HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "business_account": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Free Account Verify

post

Verify email address for free mail service such as Gmail, Yahoo!, AOL, Mail.ru etc. In many cases, it is perfectly acceptable to send email to a user of a free email service. However, in certain contexts, businesses can receive better open/response rates when only sending to non-free / business email addresses

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email/verify/free

HTTPcURLJavaScriptPython

POST /v2/email/verify/free HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "business_account": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Role Account Verify

post

Verify email address for role account, typically these addresses are associated with a role or group (postmaster, support, sales, etc.) account instead of a person. In some instances, mailing to a role address can lead to a decreased open rate and is generally advised against while sending an email

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email/verify/role

HTTPcURLJavaScriptPython

POST /v2/email/verify/role HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "business_account": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Gibberish Account Verify

post

Verify email address for gibberish account, typically these addresses are not used by the genuine users, so its highly adviceable not to accept such email addresses

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstringRequiredExample: [email protected]

timeoutintegerOptionalExample: 10000

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email/verify/gibberish

HTTPcURLJavaScriptPython

POST /v2/email/verify/gibberish HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "email": "[email protected]",
  "timeout": 10000
}

{
  "status": "success",
  "data": {
    "email_address": "[email protected]",
    "business_account": "yes",
    "verified_on": "2019-08-24T20:20:51+05:30",
    "time_taken": 38
  }
}

Get Available Credits

get

Instantly get to know the available credits.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

statusstringOptional

Response Object status

Example: success

401

Unauthorized

application/json

503

Service Unavailable

get

/email_verify/getcredits

HTTPcURLJavaScriptPython

GET /v2/email_verify/getcredits HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "available_credits": 114563,
    "credits": {
      "available": 114563,
      "subs": null,
      "available_daily_verify_limit": null,
      "reset_daily_verify_limit_date": "2019-03-04T18:30:00.000Z",
      "total": 114563
    },
    "low_credit_balance_min_threshold": 50
  }
}