API Documentation

Overview

The Validation.app API is very simple, and aims to be both informative and efficient.

It should be noted that using this service as real-time validation may introduce undesired latency for your application. If possible, defer validation lookups to a queued or batch process.

Making Requests

There's very little you need to know to make successful requests:

Important Notes

  • Always make requests using HTTPS
  • Never share your account token
  • Requests are throttled to 60 per minute

Reference

Validate an address

Allows for a single email address to be validated and have the results immediately returned.

Parameters

email Required

The email address to be validated. It must not be malformed.

ip_address Optional IP address

The IP address that is associated to the email being validated.

monitor Optional boolean

A boolean value to indicate if the email address should be monitored.

Monitoring occurs 2, 7, and 14 days after the initial validation. If the email address moves from being classified as "non-spam" to "spam" within that period a notification will be sent to your account.

POST /validate
 curl https://api.validation.app/validate
      -H 'Authorization: Bearer {token}'
      -H 'Content-Type: application/json'
      -d '[email protected]'
                    
Response
 {
      "uuid": "01860b0a-37ca-45bb-9a76-b24698636e7e",
      "request_email": "[email protected]",
      "ip_address": null,
      "is_spam": true,
      "is_deliverable": false,
      "is_blacklisted": true,
      "passes_rfc": false,
      "passes_domain_check": false,
      "passes_mx_check": false,
      "passes_spoof_check": false,
      "spam_score": 1,
      "domain_risk": 10,
      "network_type": null,
      "created_at": "2021-12-06 09:12:54",
      "updated_at": "2021-12-06 09:12:54",
      "email": {
         "uuid": "628a666c-39c6-481f-94ae-8c7312811565",
         "address": "[email protected]",
         "is_disposable": false,
         "is_free_provider": false,
         "is_role_address": true,
         "is_catchall_address": false,
         "last_checked_at": "2021-12-06 09:12:54"
      }
 }