{
  "openapi": "3.1.0",
  "info": {
    "title": "Interzoid Get Email Information API",
    "description": "This API provides validation information for email addresses to aid in deliverability. Syntax, existence of mail servers, and other tests are run to ensure delivery. Additional demographics are provided for the email address as well, including identifying generic, vulgar, education, government, or other entity type email addresses.",
    "contact": {
      "name": "API Support",
      "url": "https://www.interzoid.com",
      "email": "support@interzoid.com"
    },
    "version": "1.0.0"
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "servers": [
    {
      "url": "https://api.interzoid.com",
      "variables": {}
    }
  ],
  "paths": {
    "/getemailinfo": {
      "get": {
        "tags": [
          "Email Address Information"
        ],
        "summary": "getemailinfo",
        "description": "Get email validation information and other demographics for an email address.",
        "operationId": "getemailinfo",
        "parameters": [
          {
            "name": "license",
            "in": "query",
            "description": "Your Interzoid license API key. Register at www.interzoid.com/register-api-account",
            "required": true,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email",
            "in": "query",
            "description": "Email address to retrieve validation information",
            "required": true,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Email validation and demographic information",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetemailinfoResponse"
                }
              }
            }
          },
          "400": {
            "description": "bad request - insufficient parameters",
            "headers": {},
            "content": {}
          },
          "402": {
            "description": "credits exhausted",
            "headers": {},
            "content": {}
          },
          "403": {
            "description": "invalid license API key",
            "headers": {},
            "content": {}
          },
          "404": {
            "description": "email address not valid",
            "headers": {},
            "content": {}
          },
          "405": {
            "description": "method not allowed",
            "headers": {},
            "content": {}
          },
          "500": {
            "description": "internal server error",
            "headers": {},
            "content": {}
          }
        },
        "deprecated": false
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "GetemailinfoResponse": {
        "title": "GetemailinfoResponse",
        "type": "object",
        "properties": {
          "Email": {
            "type": "string"
          },
          "Response": {
            "type": "string"
          },
          "Info": {
            "type": "string"
          },
          "IsGovernment": {
            "type": "string"
          },
          "IsEducational": {
            "type": "string"
          },
          "IsOrganizational": {
            "type": "string"
          },
          "IsVulgar": {
            "type": "string"
          },
          "IsGeneric": {
            "type": "string"
          },
          "IsDisposable": {
            "type": "string"
          },
          "Geolocation": {
            "type": "string"
          },
          "Code": {
            "type": "string"
          },
          "Credits": {
            "type": "string"
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Email Address Information",
      "description": ""
    }
  ],
  "externalDocs": {
    "description": "API home page and documentation",
    "url": "https://www.interzoid.com/apis/email-address-validation-demographics"
  }
}