Authentication: API key or x402
Updated 2026-11-19
The API accepts two kinds of access. Every endpoint works with both, and the results are the same.
| API key | x402 | |
|---|---|---|
| Account | Yes, a free key by email | No |
| How you pay | Credits from the key's monthly plan | USDC on Base, per request |
| Header | Authorization: Bearer lp_live_... |
PAYMENT-SIGNATURE |
| Price | Credits per check (5 for domain.health and site.health, 1 for the others, per domain in a bulk request) |
The price on the pricing page |
| Used up | 429 with error = quota_exceeded |
Not applicable |
Send one or the other, never both: a request with a key and a payment is answered 400.
API key
A free key has 250 credits a month. Get one on the pricing page; the key is sent to the address you enter. Put it in LOOKPROOF_API_KEY and send it on every request:
curl -H "Authorization: Bearer $LOOKPROOF_API_KEY" \
"https://api.lookproof.dev/v1/mail/dmarc?domain=example.com"
- Every response carries
X-Quota-Limit,X-Quota-RemainingandX-Quota-Reset. GET /v1/usageshows the credits used this period. It is free and needs a key.- Requests refused by validation (
400,422) and checks that fail on our side use 0 credits. In a bulk request only the domains that succeed count. - An invalid, revoked or unknown
lp_key is answered401. It is never passed on to payment, so a client that holds a key is never made to pay by mistake. - When the credits are used up, the API answers
429witherror=quota_exceeded, anupgrade_urlandRetry-Afterset to the end of the period. Need more? Email [email protected]. See API keys and credits.
x402
Without a key, a request is answered with 402 Payment Required and the exact price. An x402 client pays in USDC on Base and sends the same request again with the PAYMENT-SIGNATURE header. No account is needed. See payments.
Limits
These are the limits configured today. A request over a limit is answered 429 with error = rate_limited and a Retry-After header, and nothing is charged.
| Access | Limit |
|---|---|
| API key, free plan | 250 credits a month, 10 requests a minute |
| x402, per IP address (IPv4 address or IPv6 /64) | 120 requests a minute and 10,000 a day |
| x402, per paying wallet | 120 requests a minute and 10,000 a day |
| x402, signed requests at once | 4 per IP address |
| Hosted MCP server without a key | 20 tool calls a day and 5 a minute per IP address, 500 a day for a shared connector network, 2,000 a day in total |
The hosted MCP server at https://api.lookproof.dev/mcp without a key is a small trial with the 1-credit tools only. With a key, it uses the key's credits like the REST API. The daily limits are counted per UTC day; the x402 limits refill evenly, so "a day" means about 24 hours.
We may change these limits to protect the service. A change is published on this page.
Machine-readable description
The OpenAPI document describes both ways in, every endpoint, its input and its response schema.