# ValidKit — Developer-First Email Validation API

> API reference (contract of record): https://api.validkit.com/api/v1/openapi.json

## What ValidKit Does

ValidKit is a real-time email validation API built for developers. It validates
email addresses at signup to reduce bounces, catch disposable emails, and
understand developer-specific patterns like plus addressing and test accounts.

Key differentiator: Developer Pattern Intelligence — ValidKit understands that
`test@example.com` is a test address (not a typo), `user+tag@gmail.com` is
valid plus addressing, and `noreply@company.com` is a system email.

## Authentication

All authenticated endpoints require an API key in the `X-API-Key` header.

## Primary Endpoint

### POST /api/v1/verify — Validate a Single Email

```bash
curl -X POST https://api.validkit.com/api/v1/verify \
  -H "X-API-Key: vk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

## Other Endpoints

| Method | Path | Auth | Description |
|--------|------|------|-------------|
| POST | /api/v1/verify/bulk | API key | Synchronous bulk validation |
| POST | /api/v1/verify/bulk/agent | API key | Agent-optimized async bulk validation |
| POST | /api/v1/accounts/create | None | Create account (returns API key) |
| GET | /api/v1/accounts/me | API key | Current account info |
| POST | /api/v1/keys/generate | API key | Generate new API key |
| GET | /api/v1/pricing | None | Public pricing tiers |
| GET | /api/v1/health | None | API health check |
| GET | /api/v1/openapi.json | None | OpenAPI 3.0 spec |

## Pricing

| Tier | Monthly price | Validations/month | Rate limit |
|------|--------------|-------------------|------------|
| Free | $0 | 1,000 | 60 req/min |
| Starter | $20 | 10,000 | 120 req/min |
| Growth | $50 | 50,000 | 600 req/min |

No credit card required for the free tier.

## MCP Server

Use ValidKit directly from Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant:

```bash
claude mcp add validkit -e VALIDKIT_API_KEY=vk_your_api_key -- npx -y @validkit/mcp-server
```

## Links

- API base URL: https://api.validkit.com
- OpenAPI spec: https://api.validkit.com/api/v1/openapi.json
- Documentation: https://docs.validkit.com
- GitHub: https://github.com/ValidKit/validkit
- MCP Server: https://github.com/ValidKit/validkit-mcp-server