---
title: "Verify a single email address"
method: POST
path: "/api/v1/verify"
tags: ["Verification"]
---

# Verify a single email address

`POST /api/v1/verify`

Performs full verification (syntax, MX, SMTP mailbox probe, disposable/role/catch-all detection) and consumes 1 credit. With a test API key (cb_test_), returns a deterministic mock result instead: the local part selects the outcome (deliverable [default], undeliverable, rejected-email, invalid-domain, invalid-syntax, risky, low-quality, catch-all, disposable, role, unknown, timeout, typo, free; insufficient-credits simulates a 402). Plus-tags work too (user+risky@). Sandbox calls never spend credits and responses include "sandbox": true.

## Request body

- object
  - `email` string, email, required

## Response `200`

Verification result

- object
  - `success` boolean
  - `data` VerificationResult
    - `email` string, email
    - `status` 'deliverable' | 'undeliverable' | 'risky' | 'unknown'
    - `subStatus` string
    - `reason` string
    - `score` integer
    - `isDeliverable` boolean
    - `toxicity` integer
    - `checks` object
      - `syntax` boolean
      - `mxRecords` boolean
      - `smtpValid` boolean, nullable
      - `isDisposable` boolean
      - `isRoleBased` boolean
      - `isFreeProvider` boolean
      - `isCatchAll` boolean, nullable
      - `hasTypo` boolean, nullable
    - `meta` object
      - `domain` string
      - `localPart` string
      - `mxHost` string, nullable
      - `provider` string, nullable
      - `dnsType` string, nullable
      - `verifiedAt` string, date-time
      - `processingTimeMs` integer
    - `riskFactors` string[]
  - `creditsRemaining` integer
  - `sandbox` boolean — Present and true only when the request was authenticated with a test (cb_test_) API key and the result is a sandbox mock.

## Other responses

- `401` — Missing or invalid API key
- `402` — Not enough credits (code INSUFFICIENT_CREDITS)

---

[API](https://skmtc.dev/clearbounce/apis/clearbounce-api.md) · [All operations](https://skmtc.dev/clearbounce/apis/clearbounce-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clearbounce/clearbounce-api/revisions/24d5e66f3f11/schema)