---
title: "Verify an email address in real time"
method: GET
path: "/api/v3"
tags: ["Single API"]
---

# Verify an email address in real time

`GET /api/v3`

## Request

- Base URL: `//api.millionverifier.com` (relative, and the document’s source URL is not known)
- URL: `//api.millionverifier.com/api/v3`
- Auth: none declared

Verify an email address in real time and get resutls in just a second.

## Query parameters

- `api` string, required
- `email` string, required
- `timeout` integer

## Response `200`

Succesful request

- union
  - SingleApiResponse
    - `email` string: The verified email address.
    - `quality` '' | 'good' | 'bad' | 'risky': The quality of the email address.
    - `result` 'ok' | 'catch_all' | 'unknown' | 'error' | 'disposable' | 'invalid': The result of email verification.
    - `resultcode` 1 | 2 | 3 | 4 | 5 | 6: The result of email verification as an integer. 1 (ok), 2 (catch_all), 3 (unknown), 4 (error), 5 (disposable), 6 (invalid)
    - `subresult` 'unknown' | 'ok' | 'internal_error' | 'invalid_syntax' | 'no_local_ip_available' | 'dns_server_failed' | 'dns_no_mx' | 'dns_no_a' | 'could_not_connect' | 'no_code_in_banner' | 'invalid_banner_code' | 'no_code_in_ehlo_response' | 'no_code_in_helo_response' | 'no_code_in_mail_from_response' | 'no_code_in_rcpt_to_response' | 'ip_blocked' | 'no_mailbox' | 'mailbox_disabled' | 'mailbox_full' | 'greylisted' | 'connection_lost' | 'connection_timeout' | 'connection_refused' | 'connection_reset_by_peer' | 'connection_no_route_to_host' | 'host_not_accept_incoming_mail' | 'mail_service_unavailable' | 'bad_domain' | 'dns_error' | 'anti_spam_system' | 'dns_no_domain' | 'dns_refused' | 'timeout_error': Subresult of email verification.
    - `free` boolean: True if the email address is provided by a free email service such as Gmail or Yahoo.
    - `role` boolean: True if the email address if linked to a role as opposed to a person. For example: admin@, sales@
    - `didyoumean` string: Autocorrection suggestion for common typos.
    - `credits` integer: Remaining credits in your account.
    - `executiontime` integer: The time in milliseconds for the email verification.
    - `error` string: Error message displayed here if result is "error".
    - `livemode` boolean: Whether the request was made with a real or demo API key
  - SingleApiResponseBadApiKey
    - `email` string: The verified email address.
    - `quality` '' | 'good' | 'bad' | 'risky': The quality of the email address.
    - `result` 'ok' | 'catch_all' | 'unknown' | 'error' | 'disposable' | 'invalid': The result of email verification.
    - `resultcode` 1 | 2 | 3 | 4 | 5 | 6: The result of email verification as an integer. 1 (ok), 2 (catch_all), 3 (unknown), 4 (error), 5 (disposable), 6 (invalid)
    - `subresult` 'unknown' | 'ok' | 'internal_error' | 'invalid_syntax' | 'no_local_ip_available' | 'dns_server_failed' | 'dns_no_mx' | 'dns_no_a' | 'could_not_connect' | 'no_code_in_banner' | 'invalid_banner_code' | 'no_code_in_ehlo_response' | 'no_code_in_helo_response' | 'no_code_in_mail_from_response' | 'no_code_in_rcpt_to_response' | 'ip_blocked' | 'no_mailbox' | 'mailbox_disabled' | 'mailbox_full' | 'greylisted' | 'connection_lost' | 'connection_timeout' | 'connection_refused' | 'connection_reset_by_peer' | 'connection_no_route_to_host' | 'host_not_accept_incoming_mail' | 'mail_service_unavailable' | 'bad_domain' | 'dns_error' | 'anti_spam_system' | 'dns_no_domain' | 'dns_refused' | 'timeout_error': Subresult of email verification.
    - `free` boolean: True if the email address is provided by a free email service such as Gmail or Yahoo.
    - `role` boolean: True if the email address if linked to a role as opposed to a person. For example: admin@, sales@
    - `didyoumean` string: Autocorrection suggestion for common typos.
    - `credits` integer: Remaining credits in your account.
    - `executiontime` integer: The time in milliseconds for the email verification.
    - `error` string: Error message displayed here if result is "error".
    - `livemode` boolean: Whether the request was made with a real or demo API key
  - SingleApiResponseMissingEmail
    - `email` string: The verified email address.
    - `quality` '' | 'good' | 'bad' | 'risky': The quality of the email address.
    - `result` 'ok' | 'catch_all' | 'unknown' | 'error' | 'disposable' | 'invalid': The result of email verification.
    - `resultcode` 1 | 2 | 3 | 4 | 5 | 6: The result of email verification as an integer. 1 (ok), 2 (catch_all), 3 (unknown), 4 (error), 5 (disposable), 6 (invalid)
    - `subresult` 'unknown' | 'ok' | 'internal_error' | 'invalid_syntax' | 'no_local_ip_available' | 'dns_server_failed' | 'dns_no_mx' | 'dns_no_a' | 'could_not_connect' | 'no_code_in_banner' | 'invalid_banner_code' | 'no_code_in_ehlo_response' | 'no_code_in_helo_response' | 'no_code_in_mail_from_response' | 'no_code_in_rcpt_to_response' | 'ip_blocked' | 'no_mailbox' | 'mailbox_disabled' | 'mailbox_full' | 'greylisted' | 'connection_lost' | 'connection_timeout' | 'connection_refused' | 'connection_reset_by_peer' | 'connection_no_route_to_host' | 'host_not_accept_incoming_mail' | 'mail_service_unavailable' | 'bad_domain' | 'dns_error' | 'anti_spam_system' | 'dns_no_domain' | 'dns_refused' | 'timeout_error': Subresult of email verification.
    - `free` boolean: True if the email address is provided by a free email service such as Gmail or Yahoo.
    - `role` boolean: True if the email address if linked to a role as opposed to a person. For example: admin@, sales@
    - `didyoumean` string: Autocorrection suggestion for common typos.
    - `credits` integer: Remaining credits in your account.
    - `executiontime` integer: The time in milliseconds for the email verification.
    - `error` string: Error message displayed here if result is "error".
    - `livemode` boolean: Whether the request was made with a real or demo API key

---

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