---
title: "Validate email addresses"
method: POST
path: "/api/v1/validate"
tags: ["Validation"]
---

# Validate email addresses

`POST /api/v1/validate`

## Request

- Base URL: `https://api.misar.io/mail`
- URL: `https://api.misar.io/mail/api/v1/validate`
- Auth: HTTP bearer

Validate a single email or a batch of up to 500 emails. Checks syntax, MX records, SMTP mailbox, disposable domains, role accounts, and catch-all detection. Consumes validation credits.

## Request body

- union
  - object
    - `email` string, email, required
    - `options` object
      - `skip_smtp` boolean
  - object
    - `emails` string[], required
    - `options` object
      - `skip_smtp` boolean

## Response `200`

Validation results

- object
  - `success` boolean
  - `data` ValidationResult
    - `email` string, email
    - `is_valid` boolean
    - `score` integer
    - `checks` object
      - `syntax` boolean
      - `mx` boolean
      - `smtp` boolean, nullable
    - `flags` object
      - `disposable` boolean
      - `role_account` boolean
      - `catch_all` boolean, nullable
      - `free_provider` boolean
    - `domain` string
    - `provider` string, nullable
    - `mx_records` string[]
    - `verified_at` string, date-time
  - `summary` object
    - `total` integer
    - `valid` integer
    - `invalid` integer
    - `risky` integer
    - `unknown` integer
    - `duration_ms` integer
  - `results` ValidationResult[]
    - `email` string, email
    - `is_valid` boolean
    - `score` integer
    - `checks` object
      - `syntax` boolean
      - `mx` boolean
      - `smtp` boolean, nullable
    - `flags` object
      - `disposable` boolean
      - `role_account` boolean
      - `catch_all` boolean, nullable
      - `free_provider` boolean
    - `domain` string
    - `provider` string, nullable
    - `mx_records` string[]
    - `verified_at` string, date-time
  - `credits` object
    - `used` integer
    - `remaining` integer

## Other responses

- `401`: Invalid API key
- `403`: Insufficient scope
- `429`: Rate limit or validation credits exhausted

---

[API](https://skmtc.dev/misar/apis/misarmail-api.md) · [All operations](https://skmtc.dev/misar/apis/misarmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misar/apis/misarmail-api/revisions/1141238bc092?raw)