Skip to main content

Verify Batch

POST /api/v1/verify/batch

Submit up to 100 policies at once. Returns a batch_id immediately. Poll GET /api/v1/batches/{batch_id} for results.

Request body​

ParameterTypeRequiredDescription
policiesarray✓Array of policy objects (see below)

Each policy object: policy_number, country, insurance_type, optional provider.

Example​

curl -X POST https://policynumbers.com/api/v1/verify/batch \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "policies": [
      {"policy_number":"ABC12345","country":"UK","insurance_type":"motor"},
      {"policy_number":"DEF67890","country":"UK","insurance_type":"motor","provider":"Aviva"}
    ]
  }'
{ "batch_id": "b1234567-...", "status": "pending", "total_count": 2 }