---
title: "Email Lookup"
method: GET
path: "/api/v2/email-lookups/{email}"
tags: ["Lookup"]
---

# Email Lookup

`GET /api/v2/email-lookups/{email}`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Lookup/doEmailLookup" target="_blank">Try in sandbox</a><br>To get more details about an email address or to check whether it is a valid email or not, you can use the Email Lookup command. To upload and check emails in bulk, please use our [Web app](https://my.textmagic.com/online/email-lookup/).

This API call allows you to retrieve additional information about an email address, such as mailbox detection, syntax checks, DNS validation, deliverability status, and many more helpful values (see the table below).

> Emails must be checked one by one. You cannot check multiple emails in one request. To upload and check emails in bulk, please use our [Web app](https://my.textmagic.com/online/email-lookup/).

## Path parameters

- `email` string, email, required

## Response `200`

Returned when successful.

- DoEmailLookupResponse
  - `address` string, email, required — The email address passed to the call.
  - `status` 'valid' | 'invalid', required — The email is `valid` or `invalid`.
  - `deliverability` string, required — The delivery status of the email address is`deliverable`, `undeliverable`. or `unknown`.
  - `reason` string, nullable, required — The reason why the checked email is invalid/undeliverable.
  - `risk` string, required — The risk score of the email is`high`, `medium`, `low` or `null`.
  - `addressType` 'corporate' | 'free', required — The email address type (domain) is `free` or `corporate`.
  - `isDisposableAddress` boolean, required — This is `true` if the domain is in the list of disposable email addresses; otherwise, it returns as `false`.
  - `suggestion` string, nullable, required — Null if nothing is suggested; however, if there is a potential typo in the email address, the closest suggestion is provided.
  - `emailRole` string, nullable, required — Checks the mailbox part of the email to see whether it matches a specific role type (‘admin’, ‘sales’, ‘webmaster’).
  - `localPart` string, required — The local part of the email address.
  - `domainPart` string, required — The domain part of the email address.
  - `exchange` string, nullable, required — Email exchange server domain name (MX record value).
  - `preference` integer, nullable, required — MX record preference.
  - `isInWhiteList` boolean, required — `true` if the email address exists in the Textmagic whitelist.
  - `isInBlackList` boolean, required — `true` if the email address exists in the Textmagic blacklist.
  - `hasMx` boolean, required — `true` if the email address domain has an MX record.
  - `hasAa` boolean, required — `true` if the email address domain has an A record (IPv4).
  - `hasAaaa` boolean, required — `true` if the email address domain has an AAAA record (IPv6).

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `404` — Request data not found.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)