> ## 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.

# Find an email

> Finds a person's work address from their name and company domain. Returns the address only when it's verified; otherwise `email` is `null`. Uses 10 requests from your balance, only when an email is found.



## OpenAPI

````yaml /openapi.json get /api/v1/find
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/find:
    get:
      tags:
        - Find
      summary: Find an email
      description: >-
        Finds a person's work address from their name and company domain.
        Returns the address only when it's verified; otherwise `email` is
        `null`. Uses 10 requests from your balance, only when an email is found.
      operationId: findEmail
      parameters:
        - name: domain
          in: query
          required: true
          description: Company domain, like acme.com.
          schema:
            type: string
          example: acme.com
        - name: first_name
          in: query
          required: true
          description: The person's first name.
          schema:
            type: string
          example: Jane
        - name: last_name
          in: query
          required: true
          description: The person's last name.
          schema:
            type: string
          example: Doe
        - name: linkedin_profile
          in: query
          required: false
          description: >-
            The person's LinkedIn profile URL. Please include it when you have
            it. Not mandatory.
          schema:
            type: string
      responses:
        '200':
          description: Result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - email
                  - esp
                properties:
                  email:
                    type: string
                    nullable: true
                    description: The verified address, or null when none was found.
                  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:
                email: jane.doe@acme.com
                esp: Google
        '400':
          description: >-
            A required field is missing (MISSING_DOMAIN, MISSING_FIRST_NAME,
            MISSING_LAST_NAME, INVALID_REQUEST).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  error: Domain is required
                  code: MISSING_DOMAIN
        '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.