---
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

---

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