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

# Verify an email

> Checks whether one address is a real mailbox, without sending anything to it. `verified` is `true` only when the mailbox is confirmed. Catch-all, unknown and invalid addresses all return `false`, so `false` doesn't always mean the address is bad. Uses 1 request from your balance.



## OpenAPI

````yaml /openapi.json get /api/v1/verify
openapi: 3.0.3
info:
  title: Email Finder Verifier API
  version: '1'
  description: >-
    Verify work emails and find them from a name and a domain. Every call needs
    your API key in the X-API-Key header.
servers:
  - url: https://api.emailfinderverifier.com
security:
  - apiKey: []
tags:
  - name: Verify
  - name: Find
  - name: Domain
  - name: Account
paths:
  /api/v1/verify:
    get:
      tags:
        - Verify
      summary: Verify an email
      description: >-
        Checks whether one address is a real mailbox, without sending anything
        to it. `verified` is `true` only when the mailbox is confirmed.
        Catch-all, unknown and invalid addresses all return `false`, so `false`
        doesn't always mean the address is bad. Uses 1 request from your
        balance.
      operationId: verifyEmail
      parameters:
        - name: email
          in: query
          required: true
          description: The address to check.
          schema:
            type: string
          example: jane@acme.com
      responses:
        '200':
          description: Result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - verified
                  - esp
                properties:
                  verified:
                    type: boolean
                    description: true only when the mailbox is confirmed.
                  esp:
                    type: string
                    description: The mail provider the domain uses.
                    enum:
                      - Google
                      - Outlook
                      - Zoho
                      - Yahoo
                      - Proofpoint
                      - Mimecast
                      - Amazon SES
                      - GoDaddy
                      - Apple
                      - Proton
                      - Yandex
                      - Rackspace
                      - IONOS
                      - Namecheap
                      - Other
              example:
                verified: true
                esp: Outlook
        '400':
          description: >-
            The email is missing or not an address (INVALID_EMAIL,
            INVALID_REQUEST).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: Invalid email address
                  code: INVALID_EMAIL
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: Invalid or missing API key
                  code: INVALID_API_KEY
        '402':
          description: Your free credits are used up.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: Out of credits. Your free credits are used up.
                  code: OUT_OF_CREDITS
        '403':
          description: >-
            The account behind this key can't use the API right now
            (ACCOUNT_NOT_FOUND or ACCOUNT_NOT_ACTIVE).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: Account is paused
                  code: ACCOUNT_NOT_ACTIVE
        '429':
          description: >-
            Too many requests (RATE_LIMIT_EXCEEDED) or too many at once
            (CONCURRENT_LIMIT_EXCEEDED).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: >-
                    Rate limit exceeded: 1/second. Upgrade tier for higher
                    limits.
                  code: RATE_LIMIT_EXCEEDED
components:
  schemas:
    Error:
      type: object
      properties:
        detail:
          type: object
          properties:
            error:
              type: string
              description: What went wrong, in plain words.
            code:
              type: string
              description: A stable code you can branch on.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key from the dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.