API & Forms Reference

const response = await fetch('https://api.insuranceblueprint.org/v1/forms/generate', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    form_type: 'POI',
    output_format: 'pdf',
    output_target: 'print',
    data: {
      policy_number: 'IBP-2026-PA-00142',
      effective_date: '2026-01-01',
      expiration_date: '2027-01-01',
      issuer: { name: 'Acme Insurance Company', naic_code: '12345' },
      named_insured: {
        name: 'John A. Smith',
        address: { street: '456 Elm Avenue', city: 'Springfield', state: 'MO', zip: '65801' }
      },
      vehicles: [{ year: 2022, make: 'Toyota', model: 'Camry', vin: '4T1B11HK1NU123456' }],
      coverages: [
        { coverage_type: 'BI',   limit_per_occurrence: 100000, limit_aggregate: 300000 },
        { coverage_type: 'PD',   limit_per_occurrence: 100000 },
        { coverage_type: 'COMP', deductible: 500 },
        { coverage_type: 'COLL', deductible: 500 }
      ]
    }
  })
});

const { form_url, form_id } = await response.json();
console.log('Form ready:', form_url);

import requests

payload = {
    "form_type": "POI",
    "output_format": "pdf",
    "output_target": "print",
    "data": {
        "policy_number": "IBP-2026-PA-00142",
        "effective_date": "2026-01-01",
        "expiration_date": "2027-01-01",
        "issuer": {"name": "Acme Insurance Company", "naic_code": "12345"},
        "named_insured": {
            "name": "John A. Smith",
            "address": {"street": "456 Elm Avenue", "city": "Springfield",
                         "state": "MO", "zip": "65801"}
        },
        "vehicles": [{"year": 2022, "make": "Toyota", "model": "Camry",
                        "vin": "4T1B11HK1NU123456"}],
        "coverages": [
            {"coverage_type": "BI",   "limit_per_occurrence": 100000, "limit_aggregate": 300000},
            {"coverage_type": "PD",   "limit_per_occurrence": 100000},
            {"coverage_type": "COMP", "deductible": 500},
            {"coverage_type": "COLL", "deductible": 500}
        ]
    }
}

r = requests.post(
    "https://api.insuranceblueprint.org/v1/forms/generate",
    headers={"Authorization": f"Bearer {api_key}"},
    json=payload
)
r.raise_for_status()
form_url = r.json()["form_url"]
print(f"Form ready: {form_url}")

const response = await fetch('https://api.insuranceblueprint.org/v1/forms/parse', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    form_type: 'POI',
    source_url: 'https://your-system.com/uploads/poi-scan.pdf'
  })
});

const { data, confidence } = await response.json();
// data conforms to IBP-DM-001
console.log('Insured:', data.named_insured.name);
console.log('Confidence:', confidence); // 0.0 – 1.0

r = requests.post(
    "https://api.insuranceblueprint.org/v1/forms/parse",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "form_type": "POI",
        "source_url": "https://your-system.com/uploads/poi-scan.pdf"
    }
)
result = r.json()
data = result["data"]          # IBP-DM-001 payload
confidence = result["confidence"]  # 0.0 – 1.0

import hmac, hashlib

def verify_webhook(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(
        secret.encode(), raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)