Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.minerva.io/llms.txt

Use this file to discover all available pages before exploring further.

mc.api.validate_emails(["test@example.com", "bad@example.invalid"])
Returns a status per email (valid, invalid, unknown) plus any associated profile info.

​
Parameters

​
records
list[str]
required
Email-address strings (1–500).
​
dry_run
bool
default:"False"
Validate input locally without sending.

​
Response shape

result = mc.api.validate_emails(["test@example.com"])
# {
#   "results": [
#     {"email": "test@example.com", "status": "valid", ...}
#   ]
# }
Status values are documented server-side and are forward-compatible. New status values added by the server won’t break older clients — match on the strings you know about.

​
Validation

dry_run=True returns the validated ValidateEmailsRequest without sending; an empty records list raises MinervaValidationError locally. See Validation.