> ## 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.

# Email validation

> Verify email addresses against the Minerva database.

```python theme={null}
mc.api.validate_emails(["test@example.com", "bad@example.invalid"])
```

Returns a status per email (valid, invalid, unknown) plus any associated
profile info.

## Parameters

<ParamField path="records" type="list[str]" required>
  Email-address strings (1–500).
</ParamField>

<ParamField path="dry_run" type="bool" default="False">
  Validate input locally without sending.
</ParamField>

## Response shape

```python theme={null}
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](/sdk/guides/validation-dry-run).