Business API
Bulk Email Check
Scale your validation workflows. Process hundreds of email addresses in a single batch request with high-performance throughput.
Endpoint#
This endpoint allows you to verify a list of email addresses simultaneously. It requires a Business subscription or higher.
POST
https://api.temp-mail.pyzit.com/v1/validate/bulk/Authentication
Requires a Bearer Token with the bulk:tempemail_check scope.
Request Body
emails(array of strings, required): A list of email addresses to verify (Max 1,000 per request).
Example Request
curl -X POST https://api.temp-mail.pyzit.com/v1/validate/bulk/ \
-H "Authorization: Bearer YOUR_BUSINESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"emails": [
"hi@pyzit.com",
"cyz@temp-mail.org"
]
}'
Success Response (200 OK)
{
"results": {
"hi@pyzit.com": false,
"cyz@temp-mail.org": true
},
"processed": 2
}
Error Responses#
Specific error responses for the Bulk Check endpoint.
Plan Restricted
Bulk checks are exclusive to Business and Enterprise plans.
Missing Scopes
Requires the bulk:tempemail_check scope.
Plan Required (403)
{
"detail": "Your plan does not support bulk checks. Upgrade to Business."
}
Missing Required Scope (403)
{
"detail": "Token missing required scope: bulk:tempemail_check"
}
Invalid/Expired Token (403)
{
"detail": "Invalid token"
}