> For the complete documentation index, see [llms.txt](https://kevins-organization-58.gitbook.io/smtp-ghost-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kevins-organization-58.gitbook.io/smtp-ghost-api/email-verification.md).

# Email Verification

Verifies a single email address and returns detailed validation results.

### Endpoint

**POST** `/api/v1/email_verification`

### Base URL

```
https://smtpghost.com/api/v1/email_verification
```

### Headers

| Header         | Value                         | Required |
| -------------- | ----------------------------- | -------- |
| `Content-Type` | `application/json`            | Yes      |
| `X-KEY`        | `<your-organization-api-key>` | Yes      |

### Request Body

```json
{
  "email_address": "kevin@voymedia.com"
}
```

### Success Response (200 OK)

{% code overflow="wrap" fullWidth="false" %}

```json
{"email_address":"kevin@voymedia.com","email_status":"VALID","account_type":"professional","is_catch_all":false,"is_disposable":false,"is_role_account":false,"last_verified_at":"2025-05-16T11:02:42.282-04:00","mx_records":[{"hostname":"alt1.aspmx.l.google.com","ip_address":"209.85.202.26","preference":5},{"hostname":"alt2.aspmx.l.google.com","ip_address":"64.233.184.26","preference":5},{"hostname":"aspmx.l.google.com","ip_address":"172.253.62.26","preference":1},{"hostname":"alt3.aspmx.l.google.com","ip_address":"142.250.27.26","preference":10},{"hostname":"alt4.aspmx.l.google.com","ip_address":"142.250.153.26","preference":10}]}
```

{% endcode %}

**Example:** Kevin Urrutia’s business email `kevin@voymedia.com` returned a `VALID` status.

### Error Responses

#### 400 Bad Request

```json
{
  "error": "Please enter an email address before verifying."
}
```

#### 402 Payment Required

```json
{
  "error": "Insufficient credits. You need 1 credit to perform email verification."
}
```

#### 500 Internal Server Error

```json
{
  "status": "error",
  "error":  "An internal error occurred during email verification: <details>"
}
```

On any unexpected exception, your credits are refunded and a 500 is returned with `status: "error"`.