openapi: 3.0.0
servers:
  - url: https://prod.api.market/api/v1/apileague/verify-email
info:
  title: "Verify Email Address API : Block Disposable Emails & Fake Sign-ups"
  description: The Verify Email Address API ensures that email addresses are
    valid, properly formatted, and not from disposable providers.
  termsOfService: https://apileague.com/terms
  version: 1.6.4
  contact:
    name: David Urbansky
    email: mail@apileague.com
paths:
  /verify-email:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  email:
                    type: string
                    nullable: true
                  domain:
                    type: string
                    nullable: true
                  first_name:
                    type: string
                    nullable: true
                  middle_name:
                    type: string
                    nullable: true
                  last_name:
                    type: string
                    nullable: true
                  full_name:
                    type: string
                    nullable: true
                  username:
                    type: string
                    nullable: true
                  image:
                    type: string
                    nullable: true
                  result:
                    type: string
                    nullable: true
                  disposable:
                    type: boolean
                  accept_all:
                    type: boolean
                  free_provider:
                    type: boolean
              examples:
                Response:
                  value:
                    email: maxtest@gmail.com
                    domain: gmail.com
                    first_name: Max
                    middle_name: null
                    last_name: Test
                    full_name: Max Test
                    username: mtst
                    image: https://0.gravatar.com/avatar/e61fff419c2ddf685b1520e768d33e40
                    result: valid
                    disposable: false
                    accept_all: false
                    free_provider: true
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: email
          description: The email address to verify.
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: maxtest@gmail.com
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://apileague.com/apis/email-verification-api/
      summary: Verify Email Address API
      tags:
        - Web
      description: This email checker API allows you to validate an email address. The
        validation will parse the name if possible and check whether the email
        is not just a disposable junk email address. The API will also check if
        the email is from a free provider like Gmail, Yahoo, or Hotmail.
      operationId: verifyEmailAddressAPI
      deprecated: false
    parameters:
      - description: API.market API Key
        in: header
        name: x-api-market-key
        value: Please Login/Signup to get an API Key
        required: true
        schema:
          type: string
components:
  schemas: {}
  securitySchemes: {}
security: {}
tags:
  - name: business
    description: Operations related to business
  - name: email
    description: Operations related to email
  - name: events
    description: Operations related to events
  - name: transportation
    description: Operations related to transportation