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_identifier: 'IBP-2026-PA-00142',
      lob_major_cd: 'Personal',
      lob_minor_cd: 'Personal/Automobile',
      effective_dt: '2026-01-01',
      expiration_dt: '2027-01-01',
      parties: [
        { role: 'carrier', party: { party_type: 'organization', display_name: 'Acme Insurance Company',
          identifiers: [{ identifier_type: 'naic', value: '12345' }] } },
        { role: 'named_insured', is_primary_ind: true, party: { party_type: 'person', display_name: 'John A. Smith',
          addresses: [{ line1: '456 Elm Avenue', city: 'Springfield', state: 'MO', postal_code: '65801' }] } }
      ],
      insurables: [
        { insurable_identifier: 'INS-VEH-1', insurable_type: 'object', insurable_subtype: 'vehicle',
          attributes: { year: 2022, make: 'Toyota', model: 'Camry' },
          identifiers: [{ identifier_type: 'vin', value: '4T1B11HK1NU123456' }] }
      ],
      coverages: [
        { coverage_cd: 'INS/US/PERS/BI',   insurable_identifier: 'INS-VEH-1', limit_per_occurrence_amt: 100000, limit_aggregate_amt: 300000 },
        { coverage_cd: 'INS/US/PERS/PD',   insurable_identifier: 'INS-VEH-1', limit_per_occurrence_amt: 100000 },
        { coverage_cd: 'INS/US/PERS/COMP', insurable_identifier: 'INS-VEH-1', deductible_amt: 500 },
        { coverage_cd: 'INS/US/PERS/COLL', insurable_identifier: 'INS-VEH-1', deductible_amt: 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_identifier": "IBP-2026-PA-00142",
        "lob_major_cd": "Personal",
        "lob_minor_cd": "Personal/Automobile",
        "effective_dt": "2026-01-01",
        "expiration_dt": "2027-01-01",
        "parties": [
            {"role": "carrier", "party": {"party_type": "organization", "display_name": "Acme Insurance Company",
             "identifiers": [{"identifier_type": "naic", "value": "12345"}]}},
            {"role": "named_insured", "is_primary_ind": True, "party": {"party_type": "person", "display_name": "John A. Smith",
             "addresses": [{"line1": "456 Elm Avenue", "city": "Springfield", "state": "MO", "postal_code": "65801"}]}}
        ],
        "insurables": [
            {"insurable_identifier": "INS-VEH-1", "insurable_type": "object", "insurable_subtype": "vehicle",
             "attributes": {"year": 2022, "make": "Toyota", "model": "Camry"},
             "identifiers": [{"identifier_type": "vin", "value": "4T1B11HK1NU123456"}]}
        ],
        "coverages": [
            {"coverage_cd": "INS/US/PERS/BI",   "insurable_identifier": "INS-VEH-1", "limit_per_occurrence_amt": 100000, "limit_aggregate_amt": 300000},
            {"coverage_cd": "INS/US/PERS/PD",   "insurable_identifier": "INS-VEH-1", "limit_per_occurrence_amt": 100000},
            {"coverage_cd": "INS/US/PERS/COMP", "insurable_identifier": "INS-VEH-1", "deductible_amt": 500},
            {"coverage_cd": "INS/US/PERS/COLL", "insurable_identifier": "INS-VEH-1", "deductible_amt": 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-002
console.log('Insured:', data.parties.find(p => p.role === 'named_insured').party.display_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-002 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)