---
title: "Verify Single Email Address"
method: GET
path: "/verify/v1/email"
tags: ["Verify API"]
---

# Verify Single Email Address

`GET /verify/v1/email`

Checks the validity and various characteristics of the given email address

## Query parameters

- `address` string, required
- `verifyCatchAll` string

## Response `200`

Successful response

- RestEmailVerificationResponse — The response structure for email verification, providing detailed validation results.
  - `alternateEmail` string — AlternateEmail provides an alternate email if available
  - `deliverable` string — Deliverable indicates whether the email is deliverable (e.g., "true", "false", "unknown")
  - `email` string — Email is the email address that was verified
  - `isCatchAll` boolean — IsCatchAll indicates if the email address is a catch-all address
  - `isRisky` boolean — IsRisky indicates whether the email address is risky (e.g., used in spam or phishing)
  - `message` string — Message contains any additional information or errors related to the verification
  - `provider` string — Provider is the email service provider (e.g., Gmail, Outlook)
  - `risk` RestEmailVerificationRisk
    - `isFirewalled` boolean — IsFirewalled indicates whether the email is protected by a firewall
    - `isFreeProvider` boolean — IsFreeProvider indicates if the email uses a free provider like Gmail or Yahoo
    - `isMailboxFull` boolean — IsMailboxFull indicates if the mailbox is full
    - `isPrimaryDomain` boolean — IsPrimaryDomain indicates if the email belongs to a primary domain (not an alias)
    - `isRoleMailbox` boolean — IsRoleMailbox indicates if the email belongs to a role (e.g., info@, support@)
  - `secureGatewayProvider` string — SecureGatewayProvider is the secure gateway provider (e.g., Proofpoint, Mimecast)
  - `status` string — Status indicates the status of the verification (e.g., "success" or "failure")
  - `syntax` RestEmailVerificationSyntax
    - `domain` string — Domain represents the domain part of the email address
    - `isValid` boolean — IsValid indicates if the syntax of the email is valid
    - `user` string — User represents the local part (before the @) of the email address

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2024-09-10** `32a769da53f1` — 1 info
  - added the non-success response with the status `500`
- **2024-09-10** `1ee4ed170cfa` — 3 info
  - api tag `Verify API` added
  - api tag `Email Verification` removed
  - removed the non-success response with the status `500`

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/verify/v1/email/get.md)

---

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