> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.mailercloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify Emails

> Verify a single email or a batch of up to **50** emails in real time. Duplicates are removed automatically. Each billable result consumes one credit; returns `402` when the account has insufficient credits. Credits are consumed for every verification attempt, including `unknown` results. Same credit balance as file uploads; active Marketing subscribers receive 250 free credits monthly.



## OpenAPI

````yaml /openapi-verifier.json post /verifyEmail
openapi: 3.1.0
info:
  title: Mailercloud Email Verifier API
  version: 1.0.0
  description: >-
    Verify email addresses programmatically — single/batch real-time
    verification and bulk file verification. Credit-based: each billable
    verification consumes one credit. Create API keys at
    [app.mailercloud.com/email-verifier/api-keys](https://app.mailercloud.com/email-verifier/api-keys).
servers:
  - url: https://verify.mailercloud.com
security:
  - bearerAuth: []
tags:
  - name: Verification
  - name: Bulk Files
paths:
  /verifyEmail:
    post:
      tags:
        - Verification
      summary: Verify Emails
      description: >-
        Verify a single email or a batch of up to **50** emails in real time.
        Duplicates are removed automatically. Each billable result consumes one
        credit; returns `402` when the account has insufficient credits. Credits
        are consumed for every verification attempt, including `unknown`
        results. Same credit balance as file uploads; active Marketing
        subscribers receive 250 free credits monthly.
      operationId: verify-emails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  description: A single email address to verify.
                emails:
                  type: array
                  items:
                    type: string
                  maxItems: 50
                  description: Up to 50 email addresses. May be combined with `email`.
            examples:
              single:
                summary: Single email
                value:
                  email: jane@example.com
              batch:
                summary: Batch
                value:
                  emails:
                    - jane@example.com
                    - bob@test.org
      responses:
        '200':
          description: Verification results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        status:
                          type: string
                          description: >-
                            Verification status, e.g. `deliverable`,
                            `undeliverable`, `risky`, `unknown`, `pending`.
                        status_info:
                          type: object
                          description: >-
                            Human-readable status, source, tag, and a suggested
                            correction for likely typos.
                        domain_server:
                          type: object
                          description: Domain/MX server details for the address.
                        account_info:
                          type: object
                          description: Mailbox-level attributes.
                        characteristics:
                          type: object
                          description: >-
                            Flags such as disposable, role account, free
                            provider, catch-all.
                        is_valid:
                          type: boolean
                          description: Whether the address is syntactically valid.
                        is_deliverable:
                          type: boolean
                        email_format:
                          type: string
                          enum:
                            - valid
                            - invalid
                        risk_level:
                          type: string
                          description: Risk bucket derived from the delivery score.
                        delivery_score:
                          type: integer
                          description: 0–100 deliverability score.
                  total:
                    type: integer
                  credits_used:
                    type: integer
        '400':
          description: Invalid body, no emails provided, or more than 50 emails.
        '401':
          description: Missing or invalid API key.
        '402':
          description: Insufficient credits.
        '503':
          description: Service busy — retry.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your Email Verifier API key, sent as `Authorization: Bearer
        YOUR_API_KEY`. Create keys at
        [app.mailercloud.com/email-verifier/api-keys](https://app.mailercloud.com/email-verifier/api-keys).

````