API v1

Base URL: https://cleanphonelist.com/v1 — auth: Authorization: Bearer <API key> on every POST. Send an Idempotency-Key header on billable calls to make retries safe.

POST /v1/phone/validate

{"phone": "+33612345678"}

1 credit (LRN) or 2 credits (with MCC/MNC). Offline-pass, duplicates and malformed numbers: 0 credits (Zero-Waste).

POST /v1/batches/estimate

{"numbers": ["+33612345678", "06 12 34 56 78"]}

Free estimate: region split, invalid and duplicate counts, credit range (max 200,000 rows).

POST /v1/phone/validate/bulk

{"numbers": ["+33612345678", "..."]}

Async job (max 200,000 rows). Exports: CSV, TSV, TXT, JSON. Duplicated E.164 rows are billed once (dedup).

GET /v1/health

Provider and queue status.