# webkitapi.dev

> Email verification and postal address validation APIs. Every response
> carries the reasons behind its verdict, and there is no confidence
> score: an uncalibrated number is a claim we cannot support.

One key and one wallet across every endpoint. The free plan covers 100
calls a month per endpoint with no card, and the quota never expires.

## Endpoints

- POST /v1/email: verdict is deliverable, undeliverable, risky or
  unknown. Checks syntax, provider rules, domain typos, throwaway
  domains, role addresses, MX, SMTP and catch-all, cheapest first.
- POST /v1/address: does a postal address exist and can it receive
  mail. France today, from the Base Adresse Nationale.
- POST /v1/signup: both at once as one combined verdict, the worst of
  its parts, with the per-signal breakdown underneath.
- POST /v1/email/bulk and GET /v1/jobs/{id}: asynchronous batches up
  to 5000 addresses, with partial results while the job runs.
  Submitted addresses are deleted 48 hours after submission.

## Honest limits

- "unknown" is a frequent and legitimate answer: catch-all domains,
  greylisting, timeouts, and postcodes we have no data for.
- Address coverage is France only. Elsewhere the answer is unknown
  rather than a guess.
- Phone verification does not exist here.

## Client libraries

- npm: @webkitapi/email, @webkitapi/typo, @webkitapi/mcp
- PyPI: webkitapi, with a Django validator
- All run offline without a key and never call the network without one.

## Pages

- /email-verification: what the email endpoint does, the eight
  checks and the typo detection
- /address-verification: French postal addresses, on the Base
  Adresse Nationale
- /signup-check: email and address as one verdict
- /spam-checker: free tool, enter any domain and get the full SPF
  and DMARC analysis with every finding explained
- /email-header-analyzer: free tool, paste raw email headers and
  see DKIM verification, Authentication-Results, mail path and
  header compliance findings
- /email-authentication: guides on how SPF, DKIM and DMARC work,
  with seven deep-dive articles on alignment, selectors, the
  SPF lookup limit and aggregate reports

## Documentation

- [API reference](https://api.webkitapi.britzel.fr/documentation): every example is a runnable curl, no signup wall
- [Pricing](https://api.webkitapi.britzel.fr/pricing)
- [OpenAPI 3.1 spec](https://webkitapi.dev/openapi.json)