Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Note: This methods accepts only one email address per call.

API Request

Code Block
POST https://api.ongage.io/email-validation/api/v1/realtime-validation
Header: 
x-api-key: THE_SECRET_KEY_HERE
Body: 
{ “email”@”address.com”}

Response

Code Block
{
    "status": "Deliverable",
    "reason": "accepted_email"
}

...

An explanation of those and the reasons you can find in our Validation online help page.

Error Response

Following are possible error responses one can get.

Out of Validation Credits

Code Block
{
  "metadata": {
    "error": true
  },
  "payload": {
    "code": 402,
    "errors": [],
    "message": "Not enough credits in your account"
  }
}

Invalid API Key

Code Block
{
  "metadata": {
    "error": true
  },
  "payload": {
    "code": 400,
    "errors": [],
    "message": "Invalid API key"
  }
}

Additional Information

Screenshot of the POST API Header

...