Developer portal

PolicyNumbers API

Verify insurance policy numbers, extract document fields, and access public economic datasets — all through a single REST API.

The web interface is free to use. API access is licensed separately. Verification endpoints consume credits.
Insurance verification Document extraction Public datasets v1
Download OpenAPI spec Open API docs Pricing
Get your free API key
Instant access. No credit card required. Free plan includes 10 verification credits and public dataset access.
Test keys return sandbox responses and never consume credits.
Insurance verification
Check whether a policy number is valid for a given insurer and insurance type. Synchronous and async modes, batch support, and document upload for AI-assisted extraction.
  • Sync: instant result, 1 credit
  • Async: webhook callback, document OCR
  • Batch: up to 100 policies per request
Document extraction
Upload a PDF insurance document and extract policy number, insurer, dates, and coverage details automatically using OCR and AI.
  • Accepts PDF up to 14 MB (base64)
  • Returns structured fields async
  • Webhook notification on completion
Public datasets
Access UK economic time-series data: inflation, fuel prices, energy costs, house prices, rent, FX rates, and more.
  • No credits required
  • Filterable by category, cadence, source
  • Freshness indicators included
Endpoints
Insurance verification
Verify policy (sync)
POST /api/v1/verify
Body: policy_number, country, insurance_type, provider (optional). Costs 1 credit.
Verify policy (async)
POST /api/v1/verify/async
Accepts a PDF document for OCR. Returns job_id. Poll or use webhook.
Verify batch
POST /api/v1/verify/batch
Submit up to 100 policies at once. Returns batch_id.
Job / batch status
GET /api/v1/jobs/<id>
Also: GET /api/v1/batches/<id> for batch results.
Document extraction
Extract document fields
POST /api/v1/documents/extract
Multipart upload of a PDF. Extracts policy fields using OCR and AI. Returns job_id.
Public datasets
List datasets
GET /api/v1/datasets
Params: q, category, source, cadence, limit, offset
Dataset series
GET /api/v1/datasets/<slug>/series
Params: limit, direction
Quick start
curl -X POST "https://api.policynumbers.com/api/v1/verify" \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"policy_number":"ABC12345","country":"UK","insurance_type":"motor"}'
For the full interactive spec with Try it out, use the API docs.