Valid Email / Documentation

Getting Started


Overview

Welcome to the Valid Email API documentation. This API allows you to validate email addresses quickly and efficiently. Below, you'll find information on how to integrate with our API, including endpoints, request parameters, and response formats.

Authentication

To use the Valid Email API, you need to authenticate your requests using an API key. You can obtain an API key by registering on our website and selecting a plan that suits your needs.

Rate Limits

The Valid Email API imposes rate limits to ensure fair usage and prevent abuse. Please refer to the individual endpoint documentation for specific rate limit details.

Endpoints


Free Validation
GET /v1/free-validation

This endpoint allows you to validate email addresses without requiring an API key. It's designed for integration testing and allows up to 1000 requests total.

Request Parameters

  • email: The email address to be validated.
    String Required

Example Request

  
    https://validemail.io/v1/free-validation?email=jake@validemail.io
  
Validate
GET /v1/validate

This endpoint requires an API key for authentication and provides more extensive validation capabilities. Users with a free plan can make up to 10,000 requests and up to 10 requests per second. If more capabilities are required, consider upgrading to one of our premium plans.

Request Parameters

  • email: The email address to be validated.
    String Required
  • api_key: Your unique API key for authentication.
    String Required

Example Request

  
    https://validemail.io/v1/validate?email=jake@validemail.io&api_key=YOUR_API_KEY
  
Response Parameters

The API response is returned in a universal and lightweight JSON format. Both endpoints return the same responses. The response contains detailed information about the validation status and attributes of the email address.

Example Response
{
    "domain": "validemail.io",
    "is_valid": "Valid",
    "message": "Email is valid",
    "has_valid_format": true,
    "is_disposable": false,
    "email": "jake@validemail.io",
    "account": "jake",
    "is_free_provider": false
}

The response object includes the following fields:

  • domain: The domain of the email address. String
  • is_valid: The validation status of the email address. Possible values are "Valid", "Invalid", or "Unknown". String
  • message: A message indicating the validation status of the email address. String
  • has_valid_format: A boolean indicating whether the email address has a valid format or not. Boolean
  • is_disposable: Is true if the email's domain is found among Valid Email's list of disposable email providers (e.g., Mailinator, Yopmail, etc) Boolean
  • email: The email address to be validated. String
  • account: The local part of the email address (before the "@" symbol). String
  • is_free_provider: A boolean indicating whether the email provider is a free provider or not. Boolean
Other Responses

Whenever a request fails, the API returns an error in JSON format. These errors include a code and a description, detailed below. Here are some examples of potential error responses that the API might return, which are not related to email validation:

Code Type Details
200 OK Everything worked as expected.
400 Bad request Indicates that the request is malformed or missing required parameters.
401 Unauthorized Occurs when the provided API key is invalid or unauthorized.
422 Quota reached You ran out of requests available for your plan, so the request was aborted. (Free plans)
429 Too many requests You reached the number of allowed requests per second. Check out our plans for request rates.
500 Internal server error There was a server-side problem that prevented the request from being fulfilled.

Code Samples


Code Samples

In this section you'll find examples of how to integrate the Valid Email API's Validate endpoint using various programming languages. These code samples demonstrate how to make the API request, handle the response, and integrate email validation into your application efficiently.


Still need help? Contact us