Public API
Simple Email Check
The fastest way to verify if an email is disposable. This endpoint returns a simplified response optimized for speed and low latency.
Endpoint#
Use this endpoint to perform a quick check on a single email address. It is perfect for real-time validation during signup flows.
POST
https://api.temp-mail.pyzit.com/v1/validate/check/Authentication
Requires a Bearer Token in the Authorization header.
Authorization: Bearer YOUR_API_TOKENRequest Body
email(string, required): The full email address you want to check.
Example Request
curl -X POST https://api.temp-mail.pyzit.com/v1/validate/check/ \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "hi@pyzit.com"
}'
Success Response (200 OK)
{
"email": "hi@pyzit.com",
"is_disposable": false,
"status": "clean"
}
Error Responses#
Common error responses you might encounter when using this endpoint.
Limit Exceeded
Triggered when your daily request quota has been reached.
Invalid Token
The provided token is either expired, revoked, or malformed.
Missing Scopes
The token was created without the simple:tempemail_check scope.
Daily Limit Exceeded (403)
{
"detail": "Daily request limit exceeded."
}
Invalid/Expired Token (403)
{
"detail": "Invalid token"
}
Missing Required Scope (403)
{
"detail": "Token missing required scope: simple:tempemail_check"
}