# Validate email address

**POST /email_verifications**

Validate an email address and return detailed verification results.

This endpoint performs the same validation as GET but accepts parameters
via request body or form data.



## Servers
- Production API: https://peopledb.co/api/v1 (Production API)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters
- **email_address** (string(email))
  Email address to validate
- **smtp_timeout** (integer)
  SMTP check timeout in seconds


## Responses
### 200
Email validation completed successfully

#### Body: application/json (object)
- **email** (string(email))
  The email address that was validated
- **valid** (boolean)
  Whether the email is considered valid
- **classification** (string)
  Overall classification of the email:
  - `valid`: Email passed all checks cleanly
  - `risky`: Email is valid but has concerns (accepts any email, DNS/SMTP assumptions, disposable email, or warnings)
  - `invalid`: Email validation failed
- **score** (integer)
  Validation score from 0-100. Higher scores indicate higher confidence.

  Scoring breakdown:
  - Syntax valid: +20 points
  - MX verified: +40 points (or +15 if assumed)
  - SMTP verified: +35 points (or +15 if accepts any email, +10 if assumed)
  - No SMTP check: +20 points
  - Warning penalty: Up to -25 points
- **score_details** (object)
  Detailed breakdown of validation scoring factors
- **errors** (array[string])
  List of validation errors encountered
- **warnings** (array[string])
  List of validation warnings
- **checks** (object)
  Individual validation check results

### 400
Bad request - missing email_address parameter

#### Body: application/json (object)
- **error** (string)
  Error message

### 401
Unauthorized - invalid or missing bearer token

#### Body: application/json (object)
- **error** (string)
  Error message


[Powered by Bump.sh](https://bump.sh)