---
title: "Email Validation"
method: GET
path: "/emails"
tags: ["Emails"]
---

# Email Validation

`GET /emails`

Query for and validate email addresses.

## Query parameters

- `api_key` string
- `query` string, required
- `tags` string

## Response `200`

Success

- EmailResponse
  - `code` 2000, required
  - `message` 'Success', required
  - `result` union, required
    - Email
      - `result` 'deliverable' | 'not_deliverable', required
      - `deliverable` boolean, required — Returns `true` if the email can be delivered
      - `disposable` boolean, required — Returns `true` if email comes from a disposable email service like temp-mail
      - `free` boolean, required — Returns `true` if the email originates from a free service like Outlook or Gmail.
      - `role` boolean, required — Returns `true` if email address represents an organisational role like `admin`, `support`, `postmaster` etc
      - `catchall` boolean, required — Returns `true` if this domain accepts all emails regardless of username
      - `suggestions` string[], required — Returns an array of suggested email addresses if the email address is not deliverable. The suggested emails are not validated.
    - UnknownEmail
      - `result` 'unknown', required
      - `deliverable` null, nullable, required — Deliverability is not known
      - `disposable` null, nullable, required — Disposability is not known
      - `free` null, nullable, required — Free email provider is not known
      - `role` null, nullable, required — Role is not known
      - `catchall` null, nullable, required — Catch-all status is not known
      - `suggestions` string[], required — Suggestions will be empty

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2024-05-14** `1b87cbe3241c` — 1 warning, 1 info
  - deleted the `query` request parameter `Tags`
  - added the new optional `query` request parameter `tags`
- **2024-04-29** `4e708815aace` — 2 info
  - added the required property `result/oneOf[subschema #1: Email Object]/suggestions` to the response with the `200` status
  - added the required property `result/oneOf[subschema #2: Unknown Email Object]/suggestions` to the response with the `200` status
- **2023-09-05** `69a98ad9ac33` — 1 info
  - added the non-success response with the status `401`
- **2023-07-06** `a5eed9e99274` — 2 info
  - added the new optional `query` request parameter `Tags`
  - the `query` request parameter `api_key` became optional

[Change history](https://skmtc.dev/ideal-postcodes/apis/api-reference/changes/emails/get.md)

---

[API](https://skmtc.dev/ideal-postcodes/apis/api-reference.md) · [All operations](https://skmtc.dev/ideal-postcodes/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideal-postcodes/api-reference/revisions/295dd3238f22/schema)