REST API · v1

API Documentation

One endpoint. JSON in, JSON out. 1 credit per request. Generate a token from your dashboard.

Endpoint

GEThttps://validmail.botpe.in/api/public/validate

Quick start

Copy and run in your terminal.

bash

curl "https://validmail.botpe.in/api/public/validate?email=test@example.com&token=YOUR_API_TOKEN"

Query Parameters

Name	Type	Required	Description
email	string	Yes	The email address to validate.
token	string	Yes	Your API token from the dashboard.

Response

json

{
  "email": "test@example.com",
  "status": "valid",
  "mx_found": true,
  "smtp_check": true,
  "disposable": false,
  "role": false,
  "free": false,
  "did_you_mean": null,
  "score": 0.97
}

JavaScript

javascript

const res = await fetch(
  `https://validmail.botpe.in/api/public/validate?email=${encodeURIComponent(email)}&token=${TOKEN}`
);
const data = await res.json();
console.log(data.status); // "valid" | "invalid" | "risky"

Python

python

import requests

r = requests.get("https://validmail.botpe.in/api/public/validate", params={
    "email": "test@example.com",
    "token": "YOUR_API_TOKEN",
})
print(r.json())

Status Codes

Code	Meaning
200	Success — see status field for validation result.
400	Bad request — missing or malformed parameters.
401	Unauthorized — invalid or missing token.
402	Out of credits — top up at /pricing.
5xx	Server error — retry with backoff.