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-Remaining and X-Quota-Reset.
  • GET /v1/usage shows 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 answered 401. 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 429 with error = quota_exceeded, an upgrade_url and Retry-After set 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.