{"openapi":"3.1.0","info":{"title":"Insurance Underwriting & Policy Intelligence API","version":"1.0.0","description":"Normalize insurance policies, compare limits and exclusions, extract deductibles, detect renewal and premium changes, find coverage gaps versus contract requirements, normalize loss runs, check underwriting evidence completeness, and compare insurance programs—using caller-uploaded documents processed locally only. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/insurance-intelligence/policy-normalize":{"post":{"operationId":"normalize_insurance_policies","summary":"Normalize insurance policies","description":"Normalize caller-supplied or locally extracted policy identity, term, and premium fields. Preliminary document analysis only—not coverage confirmation.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","policies":[{"id":"P1","policyNumber":"GL-100","insurer":"Example Mutual","insured":"Acme LLC","lineOfBusiness":"General Liability","effectiveAt":"2025-01-01","expiresAt":"2026-01-01","premium":12000,"currency":"USD","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"policyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"policyNumber":{"type":"string"},"insurer":{"type":"string"},"insured":{"type":"string"},"lineOfBusiness":{"type":"string"},"effectiveAt":{"type":"string"},"expiresAt":{"type":"string"},"premium":{"type":"number"},"premiumSupplied":{"type":"boolean"},"currency":{"type":"string"},"side":{"type":"string"},"source":{"type":"string"},"coverageConfirmed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"normalized","policyCount":1,"items":[{"id":"P1","policyNumber":"GL-100","insurer":"Example Mutual","insured":"Acme LLC","lineOfBusiness":"General Liability","effectiveAt":"2025-01-01","expiresAt":"2026-01-01","premium":12000,"premiumSupplied":true,"currency":"USD","side":"current","source":"Caller-supplied","coverageConfirmed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/policy-limit-compare":{"post":{"operationId":"compare_policy_limits","summary":"Compare policy limits","description":"Compare caller-supplied left/right or prior/renewal coverage limits. Not a coverage determination.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","limits":[{"id":"L1","coverage":"Each Occurrence","limitAmount":1000000,"side":"prior","source":"Caller-supplied"},{"id":"L2","coverage":"Each Occurrence","limitAmount":2000000,"side":"renewal","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"pairCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"coverageLeft":{"type":"string"},"coverageRight":{"type":"string"},"leftLimitAmount":{"type":"number"},"leftLimitAmountSupplied":{"type":"boolean"},"rightLimitAmount":{"type":"number"},"rightLimitAmountSupplied":{"type":"boolean"},"deltaAmount":{"type":"number"},"deltaAmountSupplied":{"type":"boolean"},"matchScore":{"type":"number"},"matched":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","pairCount":1,"items":[{"coverageLeft":"Each Occurrence","coverageRight":"Each Occurrence","leftLimitAmount":1000000,"leftLimitAmountSupplied":true,"rightLimitAmount":2000000,"rightLimitAmountSupplied":true,"deltaAmount":1000000,"deltaAmountSupplied":true,"matchScore":1,"matched":true,"coverageConfirmed":false,"source":"Caller-supplied; Caller-supplied"}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"observation","code":"limit_delta","subject":"L1","detail":"Limit delta 1000000 for coverage \"Each Occurrence\"."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/policy-exclusion-compare":{"post":{"operationId":"compare_policy_exclusions","summary":"Compare policy exclusions","description":"Compare caller-supplied exclusion schedules across prior/renewal or left/right sides. Preliminary text matching only.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","exclusions":[{"id":"E1","title":"Pollution","text":"Pollution exclusion","side":"prior","source":"Caller-supplied"},{"id":"E2","title":"Pollution","text":"Pollution exclusion","side":"renewal","source":"Caller-supplied"},{"id":"E3","title":"Cyber","text":"Cyber liability exclusion","side":"renewal","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"pairCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"titleLeft":{"type":"string"},"titleRight":{"type":"string"},"matched":{"type":"boolean"},"matchScore":{"type":"number"},"onlyIn":{"type":"string"},"coverageConfirmed":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","pairCount":2,"items":[{"titleLeft":"Pollution","titleRight":"Pollution","matched":true,"matchScore":1,"onlyIn":"both","coverageConfirmed":false,"source":"Caller-supplied; Caller-supplied"},{"titleLeft":"","titleRight":"Cyber","matched":false,"matchScore":0,"onlyIn":"right","coverageConfirmed":false,"source":"Caller-supplied"}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"observation","code":"exclusion_right_only","subject":"E3","detail":"Exclusion present on right only: \"Cyber\"."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/deductible-structure-extract":{"post":{"operationId":"extract_deductible_structures","summary":"Extract deductible structures","description":"Extract deductible/SIR amounts and apply-per structure from caller-supplied rows or local PDF text.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","deductibles":[{"id":"D1","coverage":"Each Occurrence","amount":5000,"type":"deductible","appliesPer":"occurrence","currency":"USD","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"deductibleCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"policyId":{"type":"string"},"coverage":{"type":"string"},"amount":{"type":"number"},"amountSupplied":{"type":"boolean"},"type":{"type":"string"},"appliesPer":{"type":"string"},"currency":{"type":"string"},"side":{"type":"string"},"source":{"type":"string"},"coverageConfirmed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"extracted","deductibleCount":1,"items":[{"id":"D1","policyId":"","coverage":"Each Occurrence","amount":5000,"amountSupplied":true,"type":"deductible","appliesPer":"occurrence","currency":"USD","side":"current","source":"Caller-supplied","coverageConfirmed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/renewal-change-detect":{"post":{"operationId":"detect_insurance_renewal_changes","summary":"Detect insurance renewal changes","description":"Detect insurer, premium, limit, and exclusion deltas between prior and renewal sides. Not insurer confirmation.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","policies":[{"id":"P1","policyNumber":"GL-100","insurer":"Example Mutual","premium":12000,"effectiveAt":"2025-01-01","expiresAt":"2026-01-01","side":"prior","source":"Caller-supplied"},{"id":"P2","policyNumber":"GL-200","insurer":"Example Mutual","premium":14500,"effectiveAt":"2026-01-01","expiresAt":"2027-01-01","side":"renewal","source":"Caller-supplied"}],"limits":[{"coverage":"Each Occurrence","limitAmount":1000000,"side":"prior","source":"Caller-supplied"},{"coverage":"Each Occurrence","limitAmount":2000000,"side":"renewal","source":"Caller-supplied"}],"exclusions":[{"title":"Pollution","text":"Pollution exclusion","side":"prior","source":"Caller-supplied"},{"title":"Cyber","text":"Cyber liability exclusion","side":"renewal","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"changeCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"priorValue":{"type":"string"},"renewalValue":{"type":"string"},"changed":{"type":"boolean"},"delta":{"type":"number"}},"additionalProperties":true}},"coverageConfirmed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"detected","changeCount":2,"items":[{"field":"premium","priorValue":"12000","renewalValue":"14500","changed":true,"delta":2500},{"field":"limit","coverage":"Each Occurrence","priorValue":"1000000","renewalValue":"2000000","changed":true,"delta":1000000}],"coverageConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"observation","code":"limit_delta","subject":"LIM-1","detail":"Limit delta 1000000 for coverage \"Each Occurrence\"."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/premium-change-analyze":{"post":{"operationId":"analyze_premium_changes","summary":"Analyze premium changes","description":"Analyze prior versus renewal premium amounts from caller-supplied policy or premium rows.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","premiums":[{"id":"PR1","amount":12000,"currency":"USD","side":"prior","source":"Caller-supplied"},{"id":"PR2","amount":14500,"currency":"USD","side":"renewal","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"changeCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"priorAmount":{"type":"number"},"renewalAmount":{"type":"number"},"deltaAmount":{"type":"number"},"deltaPct":{"type":"number"},"deltaPctSupplied":{"type":"boolean"},"currency":{"type":"string"},"coverageConfirmed":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","changeCount":1,"items":[{"priorAmount":12000,"renewalAmount":14500,"deltaAmount":2500,"deltaPct":20.8333,"deltaPctSupplied":true,"currency":"USD","coverageConfirmed":false,"source":"Caller-supplied; Caller-supplied"}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"observation","code":"premium_change","subject":"","detail":"Premium changed by 2500 (20.8333%)."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/coverage-gap-detect":{"post":{"operationId":"detect_coverage_gaps","summary":"Detect coverage gaps","description":"Compare caller-supplied contract requirements to supplied limits, deductibles, and exclusions. Preliminary gap signals only—not coverage confirmation.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","limits":[{"coverage":"Each Occurrence","limitAmount":1000000,"side":"current","source":"Caller-supplied"}],"deductibles":[{"coverage":"Each Occurrence","amount":5000,"source":"Caller-supplied"}],"requirements":[{"id":"R1","coverage":"Each Occurrence","minLimitAmount":2000000,"maxDeductibleAmount":10000,"requiredEndorsement":"Additional Insured","forbiddenExclusion":"Contractual Liability","source":"Caller-supplied contract"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"requirementCount":{"type":"number"},"gapCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"requirementId":{"type":"string"},"coverage":{"type":"string"},"matchedLimitAmount":{"type":"number"},"matchedLimitAmountSupplied":{"type":"boolean"},"minLimitAmount":{"type":"number"},"minLimitAmountSupplied":{"type":"boolean"},"gaps":{"type":"array","items":{"type":"string"}},"hasGap":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"detected","requirementCount":1,"gapCount":1,"items":[{"requirementId":"R1","coverage":"Each Occurrence","matchedLimitAmount":1000000,"matchedLimitAmountSupplied":true,"minLimitAmount":2000000,"minLimitAmountSupplied":true,"gaps":["limit_below_requirement","missing_required_endorsement_signal"],"hasGap":true,"coverageConfirmed":false,"source":"Caller-supplied contract"}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"conflict","code":"coverage_gap","subject":"R1","detail":"Coverage gaps: limit_below_requirement, missing_required_endorsement_signal."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/loss-run-normalize":{"post":{"operationId":"normalize_loss_runs","summary":"Normalize loss runs","description":"Normalize caller-supplied loss-run claim rows into paid/reserved/incurred fields. Not a claim adjudication.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","lossRuns":[{"id":"C1","claimNumber":"CLM-1","policyNumber":"GL-100","lossDate":"2025-06-01","status":"closed","paidAmount":25000,"reservedAmount":0,"cause":"Slip","currency":"USD","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"claimCount":{"type":"number"},"totalIncurredAmount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"claimNumber":{"type":"string"},"policyNumber":{"type":"string"},"lossDate":{"type":"string"},"reportedAt":{"type":"string"},"status":{"type":"string"},"paidAmount":{"type":"number"},"paidAmountSupplied":{"type":"boolean"},"reservedAmount":{"type":"number"},"reservedAmountSupplied":{"type":"boolean"},"incurredAmount":{"type":"number"},"incurredAmountSupplied":{"type":"boolean"},"cause":{"type":"string"},"currency":{"type":"string"},"source":{"type":"string"},"coverageConfirmed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"normalized","claimCount":1,"totalIncurredAmount":25000,"items":[{"id":"C1","claimNumber":"CLM-1","policyNumber":"GL-100","lossDate":"2025-06-01","reportedAt":"","status":"closed","paidAmount":25000,"paidAmountSupplied":true,"reservedAmount":0,"reservedAmountSupplied":true,"incurredAmount":25000,"incurredAmountSupplied":true,"cause":"Slip","currency":"USD","source":"Caller-supplied","coverageConfirmed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/underwriting-evidence-completeness":{"post":{"operationId":"check_underwriting_evidence_completeness","summary":"Check underwriting evidence completeness","description":"Check caller-supplied evidence items against a required checklist. Missing items are flagged; coverage is not confirmed.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","requiredEvidence":["Current policy declarations/schedule","Loss runs (3–5 years)","Contract insurance requirements"],"evidenceItems":[{"id":"EV1","label":"Current policy declarations/schedule","present":true,"source":"Caller-supplied"},{"id":"EV2","label":"Loss runs (3–5 years)","present":false,"source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"requiredCount":{"type":"number"},"presentCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"present":{"type":"boolean"},"matchedEvidenceId":{"type":"string"},"matchScore":{"type":"number"},"coverageConfirmed":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"coverageConfirmed":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","requiredCount":3,"presentCount":1,"items":[{"id":"REQEV-1","label":"Current policy declarations/schedule","present":true,"matchedEvidenceId":"EV1","matchScore":1,"coverageConfirmed":false,"source":"Caller-supplied"},{"id":"REQEV-2","label":"Loss runs (3–5 years)","present":false,"matchedEvidenceId":"","matchScore":1,"coverageConfirmed":false,"source":"Caller-supplied"},{"id":"REQEV-3","label":"Contract insurance requirements","present":false,"matchedEvidenceId":"","matchScore":0,"coverageConfirmed":false,"source":"Caller-supplied"}],"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"coverageConfirmed":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"missing","code":"evidence_item","subject":"Loss runs (3–5 years)","detail":"Underwriting evidence not marked present: \"Loss runs (3–5 years)\"."},{"kind":"missing","code":"evidence_item","subject":"Contract insurance requirements","detail":"Underwriting evidence not marked present: \"Contract insurance requirements\"."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/insurance-intelligence/program-comparison":{"post":{"operationId":"compare_insurance_programs","summary":"Compare insurance programs","description":"Aggregate policy, limit, exclusion, deductible, premium, coverage-gap, and renewal comparisons from caller-supplied program records only.","tags":["insurance-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/pdf","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]}},"required":["fileBase64"],"additionalProperties":false}},"policies":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"insurer":{"type":"string","maxLength":160},"insured":{"type":"string","maxLength":160},"lineOfBusiness":{"type":"string","maxLength":120},"effectiveAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"premium":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"limits":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"limitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"aggregateAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"exclusions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":2000},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"deductibles":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"type":{"type":"string","maxLength":80},"appliesPer":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current","required"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"premiums":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"policyId":{"type":"string","maxLength":80},"periodLabel":{"type":"string","maxLength":80},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"side":{"type":"string","enum":["left","right","a","b","prior","renewal","current"]},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requirements":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"coverage":{"type":"string","maxLength":160},"minLimitAmount":{"type":"number","minimum":0,"maximum":1000000000000},"maxDeductibleAmount":{"type":"number","minimum":0,"maximum":1000000000000},"requiredEndorsement":{"type":"string","maxLength":200},"forbiddenExclusion":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"lossRuns":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"claimNumber":{"type":"string","maxLength":80},"policyNumber":{"type":"string","maxLength":80},"lossDate":{"type":"string","maxLength":40},"reportedAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"paidAmount":{"type":"number","minimum":0,"maximum":1000000000000},"reservedAmount":{"type":"number","minimum":0,"maximum":1000000000000},"incurredAmount":{"type":"number","minimum":0,"maximum":1000000000000},"cause":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"evidenceItems":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":80},"present":{"type":"boolean"},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"requiredEvidence":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","policies":[{"id":"P1","policyNumber":"GL-100","insurer":"Example Mutual","insured":"Acme LLC","lineOfBusiness":"General Liability","premium":12000,"effectiveAt":"2025-01-01","expiresAt":"2026-01-01","side":"prior","source":"Caller-supplied"},{"id":"P2","policyNumber":"GL-200","insurer":"Example Mutual","insured":"Acme LLC","lineOfBusiness":"General Liability","premium":14500,"effectiveAt":"2026-01-01","expiresAt":"2027-01-01","side":"renewal","source":"Caller-supplied"}],"limits":[{"coverage":"Each Occurrence","limitAmount":1000000,"side":"prior","source":"Caller-supplied"},{"coverage":"Each Occurrence","limitAmount":2000000,"side":"renewal","source":"Caller-supplied"}],"exclusions":[{"title":"Pollution","text":"Pollution exclusion","side":"prior","source":"Caller-supplied"},{"title":"Cyber","text":"Cyber liability exclusion","side":"renewal","source":"Caller-supplied"}],"deductibles":[{"coverage":"Each Occurrence","amount":5000,"type":"deductible","appliesPer":"occurrence","source":"Caller-supplied"}],"premiums":[{"amount":12000,"side":"prior","source":"Caller-supplied"},{"amount":14500,"side":"renewal","source":"Caller-supplied"}],"requirements":[{"coverage":"Each Occurrence","minLimitAmount":2000000,"maxDeductibleAmount":10000,"requiredEndorsement":"Additional Insured","source":"Caller-supplied contract"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"sections":{"type":"object","properties":{"policies":{"type":"object","properties":{"policyCount":{"type":"number"}},"additionalProperties":true},"limits":{"type":"object","properties":{"pairCount":{"type":"number"}},"additionalProperties":true},"exclusions":{"type":"object","properties":{"pairCount":{"type":"number"}},"additionalProperties":true},"deductibles":{"type":"object","properties":{"deductibleCount":{"type":"number"}},"additionalProperties":true},"premiums":{"type":"object","properties":{"changeCount":{"type":"number"}},"additionalProperties":true},"coverageGaps":{"type":"object","properties":{"requirementCount":{"type":"number"},"gapCount":{"type":"number"}},"additionalProperties":true},"renewalChanges":{"type":"object","properties":{"changeCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"coverageConfirmed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"insurerConnected":{"type":"boolean"},"brokerConnected":{"type":"boolean"},"preliminaryDocumentAnalysisOnly":{"type":"boolean"},"pdfExtracted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","sections":{"policies":{"policyCount":2},"limits":{"pairCount":1},"exclusions":{"pairCount":1},"deductibles":{"deductibleCount":1},"premiums":{"changeCount":1},"coverageGaps":{"requirementCount":1,"gapCount":1},"renewalChanges":{"changeCount":2}},"coverageConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"insurerConnected":false,"brokerConnected":false,"preliminaryDocumentAnalysisOnly":true,"pdfExtracted":false,"findings":[{"kind":"observation","code":"limit_delta","subject":"LIM-1","detail":"Limit delta 1000000 for coverage \"Each Occurrence\"."},{"kind":"conflict","code":"coverage_gap","subject":"REQ-1","detail":"Coverage gaps: missing_required_endorsement_signal."}],"limitations":["Policies, schedules, limits, exclusions, deductibles, premiums, requirements, loss runs, and evidence items are copied only from labeled fields or local PDF/text extraction of caller-uploaded files.","No insurer or broker system is contacted and no API key is required.","PDF text extraction is local and heuristic. Scanned/image-only PDFs are not OCR-read. Missing values are not invented.","Results are preliminary document analysis for underwriting workflow support. They are not confirmation of insurance coverage, a coverage determination, or legal advice.","Program and renewal comparisons use only supplied sides/labels. Insurer confirmation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}