openapi: 3.1.0 info: title: Interzoid Email Address Validation and Demographics API description: > This API validates an email address and provides demographic insights such as company location, number of employees, revenue, X/Twitter handles, generic/disposable email address indicators and more, all based on the email address domain and structure. To use this API, you need an API key. Register for an API key at [Interzoid Registration](https://www.interzoid.com/register-api-account). For more information about this API, visit the [Email Address Validation and Demographics Documentation](https://www.interzoid.com/apis/email-address-validation-demographics). version: 1.0.0 contact: name: Interzoid Support url: https://www.interzoid.com email: support@interzoid.com externalDocs: description: API home page and documentation url: https://www.interzoid.com/apis/email-address-validation-demographics servers: - url: https://api.interzoid.com description: Production server tags: - name: Email Validation description: Validates email addresses and provides demographic insights. paths: /getemailinfo: get: tags: - Email Validation summary: Validate Email Address and Retrieve Demographics description: > This API validates an email address and provides demographic insights such as company location, number of employees, revenue, X/Twitter handles, generic/disposable email address indicators and more, all based on the email address domain and structure. **Note**: You must include your API key as the `license` parameter in the request. If you do not have an API key, register for one at [Interzoid Registration](https://www.interzoid.com/register-api-account). parameters: - name: license in: query required: true description: > Your API license key. Register for an API key at [Interzoid Registration](https://www.interzoid.com/register-api-account). schema: type: string examples: apiKey: summary: API Key Example value: "rf5123xyz78fr39" - name: email in: query required: true description: The email address to validate. schema: type: string examples: emailAddress: summary: Email Address Example value: "joesmith@amazon.com" responses: '200': description: Successful response with email validation and demographics. content: application/json: schema: type: object properties: Email: type: string description: The validated email address. Response: type: string description: Validation status of the email. Info: type: string description: Additional information about the email. Domain: type: string description: The domain of the email address. DomainOwner: type: string description: The owner of the domain. Organization: type: string description: The organization associated with the email domain. Revenue: type: string description: Revenue information for the organization. Employees: type: string description: Number of employees in the organization. HeadquartersCountry: type: string description: Headquarters country of the organization. HeadquartersCity: type: string description: Headquarters city of the organization. Currency: type: string description: Currency used by the organization. Description: type: string description: A brief description of the organization. Code: type: string description: Response code. Credits: type: string description: Remaining API credits. examples: successfulResponse: summary: Successful response example value: Email: "joesmith@amazon.com" Response: "valid" Info: "mail server ok" Domain: "amazon.com" IsGovernment: "" IsEducational: "" IsOrganizational: "" IsDisposable: "" IsVulgar: "" IsGeneric: "" Geolocation: "" DomainOwner: "Amazon.com, Inc." XHandle: "@amazon" Organization: "Amazon.com, Inc." Revenue: "469.8 billion USD (2022)" Employees: "1540000" HeadquartersCountry: "United States" HeadquartersCity: "Seattle, Washington" Currency: "USD" Rate: "1.000" Description: "Amazon is a global e-commerce and cloud computing company, known for its online retail platform, Amazon Web Services, and various consumer electronics like the Kindle and Echo." Code: "Success" Credits: "206513" '400': description: Bad request (e.g., missing or invalid parameters). content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: invalidParameters: summary: Missing or invalid parameters value: Code: 400 Message: "Invalid license key or email address missing." '402': description: API key not found. content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: apiKeyNotFound: summary: API key not found value: Code: 402 Message: "API key not found." '403': description: Insufficient API credits remaining. content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: insufficientCredits: summary: Insufficient credits value: Code: 403 Message: "Insufficient API credits remaining." '405': description: Method not allowed. content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: methodNotAllowed: summary: Wrong HTTP method value: Code: 405 Message: "Method not allowed." '429': description: Rate limits reached. content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: rateLimitReached: summary: Rate limit reached value: Code: 429 Message: "Rate limits reached." '500': description: Internal server error. content: application/json: schema: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. examples: serverError: summary: Server error value: Code: 500 Message: "Internal server error." components: securitySchemes: apiKeyAuth: type: apiKey name: license in: query schemas: ResponseError: type: object properties: Code: type: integer description: Response code. Message: type: string description: Error message. security: - apiKeyAuth: []