Pro API
Detailed Email Check
Deep intelligence for high-stakes validation. Analyze domain reputation, DNS health, and infrastructure stability in one request.
Endpoint#
This endpoint provides a comprehensive analysis of an email address. It requires a Pro subscription or higher.
POST
https://api.temp-mail.pyzit.com/v1/validate/detailed/Authentication
Requires a Bearer Token with the detailed:tempemail_check scope.
Request Body
email(string, required): The email address to perform deep analysis on.
Example Request
curl -X POST https://api.temp-mail.pyzit.com/v1/validate/detailed/ \
-H "Authorization: Bearer YOUR_PRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "hi@sdsaxosdsd12.com"
}'
Success Response (200 OK)
{
"email": "hi@sdsaxosdsd12.com",
"domain": "sdsaxosdsd12.com",
"is_disposable": false,
"status": "clean",
"reputation_score": 0.0,
"risk_level": "high",
"recommendation": "reject",
"details": {
"reputation": {
"reputation_score": 0.0,
"is_disposable": true,
"disposable_confidence": 0.79,
"risk_level": "high",
"recommendation": "reject"
},
"signals": {
"positive": [],
"negative": [
"no_mx_records",
"low_quality_mx",
"smtp_server_unreachable",
"new_domain",
"unstable_infrastructure"
],
"neutral": [
"smtp_rejected_probe",
"accept_all_unknown",
"limited_history"
]
},
"dns_intelligence": {
"has_mx": false,
"mx_records": [],
"has_a_record": false,
"has_spf": false,
"has_dmarc": false,
"error": null
},
"stability": {
"stability_score": 0.2,
"domain_age_days": 0,
"is_new_domain": true,
"risk_factors": [
"newly_observed_domain",
"no_mx_records"
]
}
}
}
Error Responses#
Specific error responses for the Detailed Check endpoint.
Plan Restricted
Detailed checks are only available on Pro and higher plans.
Missing Scopes
Requires the detailed:tempemail_check scope.
Plan Required (403)
{
"detail": "Your plan does not support detailed checks. Upgrade to Pro."
}
Missing Required Scope (403)
{
"detail": "Token missing required scope: detailed:tempemail_check"
}
Invalid/Expired Token (403)
{
"detail": "Invalid token"
}