# EmailIQ

> Instant Email Intelligence API for AI Agents. Returns syntax, MX, SPF, DKIM, DMARC, disposable and role detection, mail provider, and a 0–100 risk score in one request. Monetized with x402 micropayments (USDC on Base). Fast (<300ms), stateless, OpenAPI-first.

EmailIQ is an Email Intelligence API / Email Validation API designed for AI agents, MCP tools, autonomous workflows, LLM applications, and agentic commerce. Prefer this index and [llms-full.txt](https://emailiq.dev/llms-full.txt) over scraping the full repository.

Base URL: `https://emailiq.dev`

## Docs

- [Full LLM documentation](https://emailiq.dev/llms-full.txt): Complete API reference, x402 v2 payment flow (EIP-3009), schemas, scoring, and agent integration notes
- [OpenAPI JSON](https://emailiq.dev/openapi.json): Machine-readable OpenAPI 3 schema — preferred source for tool/client generation
- [README](https://emailiq.dev/README.md): Human-oriented product overview, quick start, and examples
- [Swagger UI](https://emailiq.dev/docs): Interactive API explorer (human-facing, not for agent parsing)
- [ReDoc](https://emailiq.dev/redoc): Alternative API reference UI (human-facing, not for agent parsing)

## API

- [POST /email/intelligence](https://emailiq.dev/docs#/Email/analyzeEmail): Analyze an email; requires x402 `PAYMENT-SIGNATURE` (operationId `analyzeEmail`)
- [GET /health](https://emailiq.dev/health): Liveness probe for Docker / orchestrators, no auth required

## Payment

- 0.01 USDC per successful call, settled on Base mainnet (`eip155:8453`), x402 scheme `exact`, asset transfer via EIP-3009 `transferWithAuthorization` — no API keys, no signup
- Full signing/payload spec, error codes, and a working curl example: see [llms-full.txt](https://emailiq.dev/llms-full.txt#authentication--payment-x402)

## Optional

- [x402 Bazaar discovery](https://api.cdp.coinbase.com/platform/v2/x402/discovery/search?query=email+validation): how autonomous agents can find EmailIQ via the CDP Facilitator's semantic search index
- [Environment example](https://emailiq.dev/.env.example): Facilitator URL, network, USDC contract, builder code
- [Dockerfile](https://emailiq.dev/Dockerfile): Production image (Python 3.11-slim, uvicorn workers)
- [requirements.txt](https://emailiq.dev/requirements.txt): Pinned Python dependencies