# 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

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"VerifyEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer","default":130000,"maximum":180000,"description":"Request wait time (in milliseconds), Maximum allowed wait time should not exceed 180,000 milliseconds"}}},"InstantVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string","description":"Response Object status"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"safe_to_send":{"type":"string"},"status":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"},"sub_status":{"type":"object","properties":{"code":{"type":"integer"},"desc":{"type":"string"}}},"detail_info":{"type":"object","properties":{"account":{"type":"string"},"domain":{"type":"string"}}},"disposable":{"type":"string"},"free":{"type":"string"},"role":{"type":"string"},"gibberish":{"type":"string"},"suggested_email_address":{"type":"string"},"profile":{"type":"string"},"bounce_type":{"type":"string"}}}}},"InstantVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"InstantVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"InstantVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"InstantVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"InstantVerifyRateLimitReachedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"}}}}},"InstantVerifyTimeoutOccuredResponseType":{"type":"object","required":["status","error"],"properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"additional_info":{"type":"object","properties":{"resource_name":{"type":"string"},"resource_value":{"type":"string"}}}}}}}}},"paths":{"/email_verify/instant":{"post":{"tags":["Email Verify"],"summary":"Instant Verify","description":"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","operationId":"verifyEmail","requestBody":{"required":true,"description":"Email to Verify Instantly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InstantVerifySuccessResponseType"},{"$ref":"#/components/schemas/InstantVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantVerifyPaymentRequiredResponseType"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantVerifyRateLimitReachedResponseType"}}}},"503":{"description":"Service Unavailable"},"524":{"description":"A Timeout Occurred","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantVerifyTimeoutOccuredResponseType"}}}}}}}}}
```

## Bulk Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BulkVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"list_id":{"type":"string"}}}}},"BulkVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyDailyLimitReachedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"BulkVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email_verify/bulk":{"post":{"tags":["Email Verify"],"summary":"Bulk Verify","description":"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","operationId":"verifyBulkEmails","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"base64"},"optimize":{"type":"string","description":"Can be either 'highest_accuracy' or 'fastest_turnaround'","default":"highest_accuracy"},"ignore_duplicate_file":{"type":"string","description":"Whether to allow file with the same name and size that match with your recent upload","default":false}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkVerifySuccessResponseType"},{"$ref":"#/components/schemas/BulkVerifyFailureResponseType"},{"$ref":"#/components/schemas/BulkVerifyDailyLimitReachedResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Bulk Verify Progress Status

> To know the overall progress status of bulk verify request

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BulkVerifyProgressStatusSuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"progress_status":{"type":"string"},"percentile":{"type":"integer"}}}}},"BulkVerifyProgressStatusFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyProgressStatusDailyLimitReachedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyProgressStatusBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"BulkVerifyProgressStatusUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email_verify/bulk/progress_status":{"get":{"tags":["Email Verify"],"summary":"Bulk Verify Progress Status","description":"To know the overall progress status of bulk verify request","operationId":"verifyBulkEmailsProgressStatus","parameters":[{"in":"query","name":"list_id","schema":{"type":"string","description":"Pass the value of bulk verify list_id property from response object"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkVerifyProgressStatusSuccessResponseType"},{"$ref":"#/components/schemas/BulkVerifyProgressStatusFailureResponseType"},{"$ref":"#/components/schemas/BulkVerifyProgressStatusDailyLimitReachedResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyProgressStatusBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyProgressStatusUnauthorizedResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Bulk Verify Result Download

> Bulk verify result download

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListIdType":{"type":"object","required":["list_id"],"properties":{"list_id":{"type":"string","description":"Pass the value of bulk list_id property from response object"}}},"BulkVerifyResultDownloadSuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"url":{"type":"string"}}}}},"BulkVerifyResultDownloadFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyResultDownloadResultFileExpiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyResultDownloadBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"BulkVerifyResultDownloadUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyResultDownloadPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/download/result":{"post":{"tags":["Email Verify"],"summary":"Bulk Verify Result Download","description":"Bulk verify result download","operationId":"downloadResultBulkEmails","requestBody":{"required":true,"description":"List ID to Bulk verify result download","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListIdType"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkVerifyResultDownloadSuccessResponseType"},{"$ref":"#/components/schemas/BulkVerifyResultDownloadFailureResponseType"},{"$ref":"#/components/schemas/BulkVerifyResultDownloadResultFileExpiredResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyResultDownloadBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyResultDownloadUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyResultDownloadPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Bulk Verify Result Removal

> Bulk verify result removal

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RemoveParamType":{"type":"object","required":["list_id"],"properties":{"list_id":{"type":"string","description":"Pass the value of bulk list_id property from response object"},"ignore_result":{"type":"boolean","description":"Set this value to true when download request is in progress, otherwise list removal will be denied","default":false}}},"BulkSuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"name":{"type":"string"},"source":{"type":"string"},"created_on":{"type":"string"}}}}},"BulkFailureListNotAvailableResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"BulkVerifyRemovalUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkVerifyRemovalPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email_verify/list/remove":{"post":{"tags":["Email Verify"],"summary":"Bulk Verify Result Removal","description":"Bulk verify result removal","operationId":"removeBulkEmailsResult","requestBody":{"required":true,"description":"List ID to bulk verify removal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveParamType"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkSuccessResponseType"},{"$ref":"#/components/schemas/BulkFailureListNotAvailableResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyRemovalUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkVerifyRemovalPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Bulk Verify Cancel

> Cancel running bulk verify contact list

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListIdType":{"type":"object","required":["list_id"],"properties":{"list_id":{"type":"string","description":"Pass the value of bulk list_id property from response object"}}},"BulkSuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"name":{"type":"string"},"source":{"type":"string"},"created_on":{"type":"string"}}}}},"BulkFailureListNotAvailableResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkFailureListNotRunningResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BulkBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}}}},"paths":{"/email_verify/list/cancel":{"post":{"tags":["Email Verify"],"summary":"Bulk Verify Cancel","description":"Cancel running bulk verify contact list","operationId":"cancelBulkVerifyList","requestBody":{"required":true,"description":"List ID to bulk verify cancel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListIdType"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkSuccessResponseType"},{"$ref":"#/components/schemas/BulkFailureListNotAvailableResponseType"},{"$ref":"#/components/schemas/BulkFailureListNotRunningResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkBadRequestResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Catch-All Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CatchAllEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"CatchAllVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"catchall":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"CatchAllVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"CatchAllVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"CatchAllVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"CatchAllVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"CatchAllVerifyTimeoutOccurredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"additional_info":{"type":"object","properties":{"resource_name":{"type":"string"},"resource_value":{"type":"string"}}}}}}}}},"paths":{"/email/verify/catchall":{"post":{"tags":["Email Verify"],"summary":"Catch-All Verify","description":"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","operationId":"verifyCatchAllEmails","requestBody":{"required":true,"description":"Catch-All Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatchAllEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CatchAllVerifySuccessResponseType"},{"$ref":"#/components/schemas/CatchAllVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatchAllVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatchAllVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatchAllVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"},"524":{"description":"A Timeout Occurred","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatchAllVerifyTimeoutOccurredResponseType"}}}}}}}}}
```

## Disposable Account Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DisposableEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"DisposableVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"catchall":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"DisposableVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"DisposableVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"DisposableVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"DisposableVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email/verify/disposable":{"post":{"tags":["Email Verify"],"summary":"Disposable Account Verify","description":"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","operationId":"verifyDisposableEmails","requestBody":{"required":true,"description":"Dsiposable Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisposableEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DisposableVerifySuccessResponseType"},{"$ref":"#/components/schemas/DisposableVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisposableVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisposableVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisposableVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Business Account Verify

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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BusinessEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"BusinessAccountVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"business_account":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"BusinessAccountVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BusinessAccountVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"BusinessAccountVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"BusinessAccountVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email/verify/business":{"post":{"tags":["Email Verify"],"summary":"Business Account Verify","description":"Verify email address belongs to business (a.k.a work) account","operationId":"verifyBusinessEmails","requestBody":{"required":true,"description":"Business Account Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BusinessAccountVerifySuccessResponseType"},{"$ref":"#/components/schemas/BusinessAccountVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessAccountVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessAccountVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessAccountVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Free Account Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"FreeEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"FreeAccountVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"business_account":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"FreeAccountVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"FreeAccountVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"FreeAccountVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"FreeAccountVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email/verify/free":{"post":{"tags":["Email Verify"],"summary":"Free Account Verify","description":"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","operationId":"verifyFreeEmail","requestBody":{"required":true,"description":"Free Account Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FreeAccountVerifySuccessResponseType"},{"$ref":"#/components/schemas/FreeAccountVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeAccountVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeAccountVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeAccountVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Role Account Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RoleEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"RoleAccountVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"business_account":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"RoleAccountVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"RoleAccountVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"RoleAccountVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"RoleAccountVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email/verify/role":{"post":{"tags":["Email Verify"],"summary":"Role Account Verify","description":"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","operationId":"verifyRoleEmail","requestBody":{"required":true,"description":"Role Account Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RoleAccountVerifySuccessResponseType"},{"$ref":"#/components/schemas/RoleAccountVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleAccountVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleAccountVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleAccountVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Gibberish Account Verify

> 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

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GibberishEmail":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"timeout":{"type":"integer"}}},"GibberishAccountVerifySuccessResponseType":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"email_address":{"type":"string"},"business_account":{"type":"string"},"verified_on":{"type":"string"},"time_taken":{"type":"integer"}}}}},"GibberishAccountVerifyFailureResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"GibberishAccountVerifyBadRequestResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"message":{"type":"string"},"reasons":{"type":"array","items":{"properties":{"field":{"type":"array","items":{}},"location":{"type":"string"},"messages":{"type":"array","items":{}},"types":{"type":"array","items":{}}}}}}}}},"GibberishAccountVerifyUnauthorizedResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"GibberishAccountVerifyPaymentRequiredResponseType":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"paths":{"/email/verify/gibberish":{"post":{"tags":["Email Verify"],"summary":"Gibberish Account Verify","description":"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","operationId":"verifyGibberishEmail","requestBody":{"required":true,"description":"Gibberish Account Email to Verify","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GibberishEmail"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GibberishAccountVerifySuccessResponseType"},{"$ref":"#/components/schemas/GibberishAccountVerifyFailureResponseType"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GibberishAccountVerifyBadRequestResponseType"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GibberishAccountVerifyUnauthorizedResponseType"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GibberishAccountVerifyPaymentRequiredResponseType"}}}},"503":{"description":"Service Unavailable"}}}}}}
```

## Get Available Credits

> Instantly get to know the available credits.

```json
{"openapi":"3.0.2","info":{"title":"Clearout OpenAPI","version":"1.1"},"tags":[{"name":"Email Verify","description":"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."}],"servers":[{"url":"https://api.clearout.io/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GetCreditsSuccessResponseType":{"type":"object","properties":{"available_credits":{"type":"integer"},"credits":{"type":"object","properties":{"available":{"type":"integer"},"subs":{"type":"string"},"available_daily_verify_limit":{"type":"string"},"reset_daily_verify_limit_date":{"type":"string"},"total":{"type":"integer"}}},"low_credit_balance_min_threshold":{"type":"integer"}}},"GetCreditsUnauthorizedResponseType":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/email_verify/getcredits":{"get":{"tags":["Email Verify"],"summary":"Get Available Credits","description":"Instantly get to know the available credits.","operationId":"getAvailableCredits","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response Object status"},"data":{"$ref":"#/components/schemas/GetCreditsSuccessResponseType"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"array","items":{"properties":{"status":{"type":"string","description":"Response Object Status for 401"},"error":{"$ref":"#/components/schemas/GetCreditsUnauthorizedResponseType"}}}}}}},"503":{"description":"Service Unavailable"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clearout.io/developers/api/email-verify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.