MAILMAID VERIFY API™

One request. An explicit result.

A verification endpoint for server-side workflows. Configure the account service and verification provider before making live requests.

Get started

Connect your account in Engine.
Have the account-service operator configure the provider and verification migration.
Create a verification-only key under Deliverability → API keys.
Call the endpoint from your server. Keys expire after 90 days.

Open verification settings

Handle every status

Status	Meaning
`deliverable`	Provider reported acceptance; placement is not guaranteed.
`undeliverable`	Provider reported a failure; inspect the reason.
`risky`	A risk signal needs review.
`unknown`	Provider evidence was unavailable or ambiguous.
`invalid`	The supported local format check failed.
`review`	An extended format requires a more capable parser.

POST /api/v1/verify

curl -X POST https://engine.mailmaid.ai/api/v1/verify \
  -H 'Authorization: Bearer YOUR_VERIFICATION_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"email":"person@your-domain.com"}'

Use an Authorization header. Never put the key in a URL or public client bundle.

Example response shape

Illustrative schema, not a live verification result.

{
  "email": "person@your-domain.com",
  "normalized": "person@your-domain.com",
  "status": "unknown",
  "reason": "provider_timeout_or_error",
  "mailbox": "not_checked",
  "score": null,
  "flags": {
    "role": false,
    "free": false,
    "disposable": false
  },
  "suggestion": null
}

Limits and failure handling

The API allows 30 requests per minute per account. Reviewed bulk jobs accept up to 20 addresses, with at most three new jobs per minute. Account entitlements still apply. A rate-limit response is HTTP 429; an unconfigured provider is HTTP 503. Responses preserve unknown results rather than guessing.

Browser operations use a same-origin signed-in session. API keys grant verification only; they do not authorize mailbox access, sending, key management or report deletion. Bulk jobs use a stable request ID and encrypted, owner-scoped reports. Provider charges are separate; MailMaid credit packs and an SLA are not offered in this release.