---
title: "Verify an Email Address"
method: POST
path: "/v1/tools/email_verify"
---

# Verify an Email Address

`POST /v1/tools/email_verify`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/email_verify`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Check whether an email address is real and safe to send to. Says if it will arrive or bounce (deliverable, undeliverable, risky, unknown), flags throwaway, role-based (info@, sales@), catch-all and free-mail addresses, and suggests a fix for typos like gmail.con. Use it before sending outreach or to clean up a sign-up list.

Price: $0.02 per call. Charged per address checked, including results of unknown or risky.

## Request body

- object
  - `email` string, required: The email address to check, e.g. "jane@acme.com".

## Response `200`

Success

- object
  - `tool` 'email_verify', required
  - `result` object, required
    - `email` string, required: The address that was checked.
    - `status` 'deliverable' | 'undeliverable' | 'risky' | 'unknown', required: Whether mail to it will arrive.
    - `reason` string, required: Why, e.g. mailbox_exists, invalid_syntax, disposable_domain, catch_all.
    - `flags` object, required: Address traits.
      - `disposable` boolean, required
      - `role` boolean, required
      - `catch_all` boolean, required
      - `free_provider` boolean, required
    - `did_you_mean` string: Suggested correction for a likely typo.
    - `checked_by` 'local_precheck' | 'supplier', required: local_precheck = answered by free local checks.
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)