Quickstart

1. Get an API key

Go to policynumbers.com/api, enter your email, and click Generate API key. Copy the pk_live_ key shown.

2. Verify a policy

curl -X POST https://policynumbers.com/api/v1/verify \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "policy_number": "AXK12345678",
    "country": "UK",
    "insurance_type": "motor",
    "provider": "AXA"
  }'

Response:

{
  "status": "verified",
  "confidence_score": 0.96,
  "verification_sources": ["format", "fca_register", "registry"],
  "insurer": {
    "name": "AXA Insurance UK plc",
    "reference": "202312",
    "regulated": "YES",
    "authorised": true
  },
  "flags": [],
  "credits_charged": 1,
  "processed_in_ms": 312
}

3. Understanding the response

Field	Description
status	verified, inconclusive, or unverified
confidence_score	0.0–1.0. Above 0.7 is a strong signal.
verification_sources	Which checks ran: format, fca_register, registry
insurer	FCA-registered entity matched to the provider
credits_charged	Credits deducted (0 for sandbox keys)

4. Next steps

• Sandbox testing — test with pk_test_ keys, zero credits consumed
• Async verification — upload PDFs for OCR-assisted verification
• Batch verification — verify up to 100 policies at once
• MCP integration — use PolicyNumbers from Claude and other AI agents