Claims Assist API Documentation

Parse supplied policy documents, organize incident facts and evidence, perform preliminary checks, and draft insurer correspondence. Payment is the exact USDC price on Base with x402.

POSThttps://brainiac.software/api/v1/claims/analyze$0.10 USDC

Analyze a policy and prepare claim evidence

Extract policy clauses, run a preliminary text-match screen, and build a general evidence checklist. This is not legal advice or confirmation of coverage.

Body

Field	Required	Notes
`filename`	Yes	string; Default: "policy.pdf"
`fileBase64`	Yes	string
`incidentDate`	No	string; date
`incidentType`	Yes	string
`description`	Yes	string
`knownDocuments`	Yes	array; Default: []; Array

Request exampleJSON

{
  "filename": "policy.pdf",
  "fileBase64": "<base64 document omitted>",
  "incidentDate": "2026-10-20",
  "incidentType": "property damage",
  "description": "Water damage in the insured building",
  "knownDocuments": []
}

The base64 document is shortened here; send the full encoded document.

Response exampleJSON

{
  "policy": {
    "sourceHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "parsedAt": "2026-10-29T12:00:00.000Z",
    "status": "WARN",
    "confidence": 0.61,
    "clauses": [
      {
        "id": "clause-1",
        "category": "coverage",
        "heading": "Coverage",
        "excerpt": "Example clause excerpt",
        "confidence": 0.61,
        "page": 1
      }
    ],
    "limitations": [
      "Text extraction may omit scanned or image-only policy content."
    ],
    "noticePeriodDays": null
  },
  "screening": {
    "status": "WARN",
    "screeningOnly": true,
    "checklist": [],
    "noticePeriodDays": null,
    "disclaimer": "Preliminary text match only."
  },
  "evidence": {
    "incidentType": "property damage",
    "checklist": [],
    "disclaimer": "General claim preparation suggestion."
  },
  "timeline": {
    "incidentDate": "2026-10-20",
    "noticePeriodDays": null,
    "noticeDueDate": null,
    "statutoryDeadlinesInferred": false
  }
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/claims/analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "filename": "policy.pdf",
  "fileBase64": "<base64 document omitted>",
  "incidentDate": "2026-10-20",
  "incidentType": "property damage",
  "description": "Water damage in the insured building",
  "knownDocuments": []
}
JSON

POSThttps://brainiac.software/api/v1/claims/letter-draft$0.02 USDC

Draft insurer correspondence

Prepare a human-reviewed FNOL, follow-up, or complaint letter. BRAINIAC.software does not send the message or make legal conclusions.

Body

Field	Required	Notes
`kind`	Yes	string; One of: fnol, chase, complaint
`insurer`	Yes	string
`policyNumber`	No	string
`claimNumber`	No	string
`incidentDate`	No	string; date
`summary`	Yes	string
`requestedAction`	No	string

Request exampleJSON

{
  "kind": "fnol",
  "insurer": "Example Insurer",
  "incidentDate": "2026-10-20",
  "summary": "Water damage occurred at the insured property."
}

Response exampleJSON

{
  "subject": "First notice of loss - CLM-100",
  "body": "To Example Insurer,\n\nPlease confirm the next steps.",
  "sent": false
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/claims/letter-draft" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "kind": "fnol",
  "insurer": "Example Insurer",
  "incidentDate": "2026-10-20",
  "summary": "Water damage occurred at the insured property."
}
JSON