# Email Verify

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/email/verify` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/email-verify |

## Description

Verify whether an email address is valid and deliverable, returning a clear status to prevent bounces and maintain list hygiene.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/email/verify' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Verify piloterr.com email address

```json
{
  "email": "g.scaglia@piloterr.com",
  "status": "invalid"
}
```

### Verify a valid email address

```json
{
  "email": "anthony.roberto@piloterr.com",
  "status": "valid"
}
```

## Documentation

## Overview
The Email Verify endpoint checks whether a given email address is valid and deliverable. It performs real-time verification against the mail server and returns a clear status to help you maintain clean contact lists and reduce bounce rates.

## Quickstart
```
GET https://api.piloterr.com/v2/email/verify?query=remi.agosta@piloterr.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The email address to verify |

## Response fields
| Field | Type | Description |
|---|---|---|
| `email` | string | The verified email address |
| `status` | string | `valid`, `invalid`, or `unknown` |

## Notes
- Real-time SMTP verification against the target mail server.
- `unknown` is returned for catch-all domains that accept all addresses.

## Main use cases
- Clean and validate email lists before sending campaigns to eliminate hard bounces
- Gate sign-up forms by verifying email addresses in real time during registration
- Audit and enrich CRM databases by identifying invalid or stale email contacts
- Protect sender reputation by removing undeliverable addresses from mailing lists