Get started / Authentication

Authentication

Every request is authenticated with an API key. Create and manage keys in your dashboard under Profile, API Keys. A key carries your credits, so treat it like a password and keep it server-side.

Header (recommended)

Send the key in the X-API-KEY header on every call.

Authenticated request

curl -X POST "https://api.primeverifier.com/v1/verify/single" \
  -H "X-API-KEY: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'

Query parameter (browser tests only)

For a quick check from a browser, the single-verify GET also accepts the key and email as query parameters. Never do this from a real app, the key would leak in logs and history.

Quick GET

https://api.primeverifier.com/v1/verify/[email protected]&X-API-KEY=pk_live_...

Keep keys server-side. Do not ship an API key in front-end JavaScript, a mobile app, or a public repo. If a key leaks, rotate it in the dashboard, the old key stops working immediately.

Missing or invalid key

A request with no key, or a revoked one, returns 401 Unauthorized with the standard error envelope. See Errors.