> ## Documentation Index
> Fetch the complete documentation index at: https://orbisearch.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# validate_email

> Checks whether one email address exists and accepts mail.

Checks whether one email address exists and accepts mail.

**Charged:** 0.2 credits per call. If the time runs out the result is `unknown` and the call is still charged, as on the API. If our own time limit stops it, the charge is refunded.

## Inputs

| Input | Required | Description |
| - | - | - |
| `email` | Yes | Email address to validate. |
| `timeout` | No | Seconds to wait (3-97). If time runs out the result is unknown, not an error. Default 97. |
| `retry_greylisted` | No | If the mail server says to try again later, wait about a minute and retry once. Needs a timeout of at least 80. |

`retry_greylisted` needs a `timeout` of at least 80. With a shorter timeout the call is refused with `invalid_input` and nothing is charged.

## What comes back

A `status` (`safe`, `risky`, `invalid` or `unknown`), a `substatus` with the reason, a plain-English `explanation`, the `email_provider`, a `confidence` score, and flags for catch-all domains and for disposable, role and free addresses.

The output is the response of [GET /v1/verify](https://orbisearch.com/docs/api-reference/verify-email.md), so that page has the full field reference.

## Example

> Is [jane.doe@acme.com](mailto:jane.doe@acme.com) safe to email?


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.