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

# Email Validation

`GET /emails`

## Request

- Base URL: `https://api.addresszen.com/v1`
- URL: `https://api.addresszen.com/v1/emails`
- Auth: HTTP bearer

Validates an email address and reports whether it is deliverable.

Requires an API Key licensed for email validation. A query over 320 characters is rejected.

A validated address decrements your lookup balance. An address the API cannot check returns `unknown` and costs no lookup. An address whose domain does not resolve, or publishes no MX records, returns `not_deliverable` and also costs no lookup. Only those two domain failures populate `suggestions`. Every other response returns an empty list.

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

- `default`: Error

---

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