Validate an email
emails:validate or mcp:use scope. Each completed validation uses one API credit.
Validation waits up to 20 seconds for a result. A timeout can produce
temp_error. SuperData does not currently offer webhook delivery or private mode through this endpoint.
Response
validity can be valid, ambiguous, maybe_valid, invalid, uncached, malformed, temp_error, or perm_error. Treat ambiguous, maybe_valid, greylisting, and catch-all signals as inconclusive rather than guaranteed delivery. retry_after indicates when a greylisted address may be worth checking again. uncached means the cached strategy found no stored result.
Errors use the REST error envelope. Invalid input returns 400, insufficient scope 403, credit or rate limits 429, and upstream failures 502. Authentication, validation, and rate-limit rejections before provider work use zero credits.