# Email Validate

> Email Validate is a paid API for AI agents from grim-foundry-pilot.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Validates a single email address for syntax, MX record existence, disposability, role-based status, and estimated deliverability

## Facts

- Endpoint: POST https://grim-foundry-pilot.onrender.com/v1/email-validate
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/email-validate-d4594127
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FefMK9L3pzL6sqyvC8I5p

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability email-validate-d4594127 -d '<json body>'
```

Example prompt: Can you check whether 'john.doe@gmail.com' is a valid, deliverable email — tell me if it's disposable, role-based, or has any MX record issues?

## When to prefer this

Use this endpoint when you need a fast, multi-signal email check that goes beyond simple regex validation — combining syntax, DNS/MX lookup, disposable provider detection, role-based detection, and deliverability scoring in a single call. It's especially useful when you want to reduce bounce rates, filter throwaway signups, or flag risky addresses before sending. Prefer this over basic regex libraries when MX record resolution or disposable-domain intelligence is required. Payment is per-call via x402 (no API key needed).

## Known failure modes

- Email fails syntax validation — syntax_valid returns false with relevant reasons
- Domain has no MX records — mx.exists false, deliverability likely 'undeliverable'
- Payment required but not provided — HTTP 402 with x402 payment offer
- Invalid input format (email too long or malformed) — validation error response
- Mailbox verification unavailable — mailbox_verified returns false even for real addresses

## How this service works

Four JSON APIs for agents. Paid operations use x402 v2 HTTP payment, not API-key authentication. Read the current PAYMENT-REQUIRED offer before paying.

## Output

Returns a JSON object with: syntax validity flag, normalized email, domain, MX record details (existence, status, records with priority), deliverability estimate (e.g. 'likely'), disposable flag, role-based flag, free provider flag, mailbox verified flag, typo suggestion if applicable, and a list of reason codes. Also includes service name and a request UUID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "email": {
   "type": "string",
   "maxLength": 254,
   "minLength": 3,
   "description": "One email address with an ASCII dot-atom local part (maximum 64 characters) and a public hostname domain. Domain is IDN-normalized; local part is preserved."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "mx": {
    "exists": true,
    "status": "present",
    "records": [
     {
      "exchange": "gmail-smtp-in.l.google.com",
      "priority": 5
     }
    ]
   },
   "email": "user@gmail.com",
   "domain": "gmail.com",
   "reasons": [],
   "disposable": false,
   "normalized": "user@gmail.com",
   "role_based": false,
   "syntax_valid": true,
   "free_provider": true,
   "deliverability": "likely",
   "typo_suggestion": null,
   "mailbox_verified": false
  },
  "service": "email_validate",
  "request_id": "00000000-0000-4000-8000-000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/email-validate-d4594127/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grim-foundry-pilot.onrender.com](https://www.zero.xyz/host/grim-foundry-pilot.onrender.com/llms.txt)