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

# Look up a domain

> Tells you about a company domain: its mail provider, whether it's catch-all, its age and whether its website is up. The catch-all answer is kept for 7 days.



## OpenAPI

````yaml /openapi.json get /api/v1/domain
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/domain:
    get:
      tags:
        - Domain
      summary: Look up a domain
      description: >-
        Tells you about a company domain: its mail provider, whether it's
        catch-all, its age and whether its website is up. The catch-all answer
        is kept for 7 days.
      operationId: domainLookup
      parameters:
        - name: domain
          in: query
          required: true
          description: Company domain, like acme.com.
          schema:
            type: string
          example: acme.com
        - name: include_catchall
          in: query
          required: false
          description: Check whether the domain is catch-all. Defaults to true.
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  esp:
                    type: string
                    nullable: true
                    description: >-
                      The mail provider, by product name (for example "Google
                      Workspace").
                  domain_age_years:
                    type: number
                    nullable: true
                  is_catchall:
                    type: boolean
                    nullable: true
                    description: >-
                      true when the domain accepts mail for any address. null
                      when it couldn't be checked or include_catchall=false.
                  has_active_website:
                    type: boolean
                    nullable: true
                  redirects:
                    type: boolean
                    nullable: true
                  redirects_to:
                    type: string
                    nullable: true
              example:
                domain: acme.com
                esp: Google Workspace
                domain_age_years: 12.4
                is_catchall: true
                has_active_website: true
                redirects: true
                redirects_to: https://www.acme.com/
        '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.