---
title: "Performs single email verification"
method: POST
path: "/v1/emails/verify"
tags: ["Email Verification"]
---

# Performs single email verification

`POST /v1/emails/verify`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/emails/verify`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

This endpoint is for single email verification.

## Headers

- `X-Request-Id` string

## Request body

- EmailVerificationSingleRequest: Request Body for single email verification
  - `email` string, required: Email which needs to be validated

## Response `200`

Email Verified Successfully

- EmailVerificationSingleResponse: response of single email verification
  - `response` EmailSingleResponse: Single email verification response
    - `status` 'OK' | 'ZERO_RESULTS', required: Represents the status of a response
    - `email` EmailVerification: Email Verification Response
      - `address` string: The email address to be validated
      - `result` string: The status of the validated email
      - `subResult` string: The sub status of the validated email
      - `freeEmail` string: [true/false] If the email comes from a free provider
      - `didYouMean` string: Suggestive Fix for an email typo
      - `account` string: The portion of the email address before the "@" symbol
      - `domain` string: The portion of the email address after the "@" symbol
      - `domainAgeDays` string: Age of the email domain in days
      - `smtpProvider` string: The SMTP Provider of the email
      - `mxFound` string: [true/false] Does the domain have an MX record
      - `mxRecord` string: The preferred MX record of the domain
      - `firstName` string: The first name of the owner of the email when available
      - `lastName` string: The last name of the owner of the email when available
      - `gender` string: The gender of the owner of the email when available
      - `processedAt` string: The time the email was validated in ISO 8601 format
      - `error` string: message from the underlying service

## Other responses

- `400`: Invalid request for Email API
- `401`: Unauthorized: Invalid tokenfor Email API
- `403`: Forbidden for Email API
- `429`: Too many requests for Email API
- `500`: Internal Server Error for Email API
- `503`: Email Verification Service unavailable

---

[API](https://skmtc.dev/precisely/apis/third-party-api-service.md) · [All operations](https://skmtc.dev/precisely/apis/third-party-api-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/third-party-api-service/revisions/cf792ff5cabd?raw)
