# Email Validation Guide

Check if an email address is deliverable using our Email Validation service.

## Available Information[​](#available-information "Direct link to Available Information")

The following information is available when you send an address to our Email Validation Service.

### Can this address receive emails?[​](#can-this-address-receive-emails "Direct link to Can this address receive emails?")

The most important attribute we return is called the result. This indicates whether you can expect an email address to be valid. The result can be `Deliverable`, `Undeliverable` or `Unknown`.

* **Deliverable.** Emails are received by the intended recipient.
* **Undeliverable.** If you receive an "undeliverable" notification for an email you sent, it could be because the recipient's email server is temporarily unavailable or experiencing high volume, or because the server could not be found. If the server is temporarily down for maintenance or some other reason, you will need to wait to resend the email. However, if the email continues to bounce back, it is possible that the server is no longer in operation.
* **Unknown.** No data is available for this email address.

### Deliverable Email Addresses[​](#deliverable-email-addresses "Direct link to Deliverable Email Addresses")

Indicates email deliverability.

`deliverable` can be `true` or `false`.

### Catchall Addresses[​](#catchall-addresses "Direct link to Catchall Addresses")

Indicates the domain appears to accept all emails addressed to that domain.

`catchall` can be `true` or `false`.

### Free Email Supplier[​](#free-email-supplier "Direct link to Free Email Supplier")

Indicates the address uses a free email service like gmail.com or outlook.com.

`free` can be `true` or `false`.

### Role[​](#role "Direct link to Role")

Indicates the address is a role address. For example: <admin@example.com>, <support@ideal-postcodes.co.uk>, etc.

`role` can be `true` or `false`.

### Disposable[​](#disposable "Direct link to Disposable")

Checks if the email address uses a disposable domain like temp-mail.org or guerillamail.com.

`disposable` can be `true` or `false`.

## API Integration[​](#api-integration "Direct link to API Integration")

Supply the email address as `query` along with your `api_key` to our Emails API as below:

```
https://api.ideal-postcodes.co.uk/v1/emails?api_key=YOUR_KEY&query=support@ideal-postcodes.co.uk
```

Full information can be found in our [API Documentation](https://docs.ideal-postcodes.co.uk/api#tag/Emails).