# BRAINIAC Public Records Incident Cluster API

> BRAINIAC Public Records Incident Cluster API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Clusters public-records incidents, charges, notices, and crime statistics by offense type and area, labeling each record's legal status without inferring guilt

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/public-records/incident-cluster?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-public-records-incident-cluster-api-2622a8a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fZw20f2eR8X__XVUvivtd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-public-records-incident-cluster-api-2622a8a3 -d '<json body>'
```

Example prompt: I have a list of 50 public enforcement records for a vendor we're vetting — can you cluster them by offense type and area, label each one as an allegation, charge, or judgment (never treating an allegation as a conviction), and give me a summary as of today?

## When to prefer this

Choose this endpoint when you need to group and legally-label public records (incidents, notices, crime stats) without any guilt inference — ideal for compliance workflows, vendor due diligence, and background screening where distinguishing allegations from convictions is legally critical. Prefer over generic NLP classifiers because it enforces strict legal-status labeling, never infers guilt, and explicitly flags all limitations. Use when you have structured incident data (CSV, JSON, text, or a public feed URL) and need compliance-safe clustering at a fixed low cost with no account required.

## Known failure modes

- Input exceeds size limits (csv/json/text maxLength 200000, file base64 maxLength 12000000) — returns validation error
- Feed URL unreachable or returns non-200 — feed ingestion fails
- Malformed date in asOf field — may return error or be ignored
- Incidents array exceeds 1000 items or notices array exceeds 400 items — truncated or rejected
- mediaType mismatch with actual file content — parsing error
- Missing required file fields (mediaType or fileBase64) when file object is provided — validation error
- Payment not received via x402 protocol — 402 response with payment instructions

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns an array of incident clusters, each containing a cluster key (offense|area), list of incidents with legal status labels (isAllegation, isCharge, isJudgment, isPenalty, etc.), date ranges, inferred-guilt flags (always false), and a findings array with coded observations. Also includes a checkedAt timestamp and a limitations array explaining data provenance and what was not inferred.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "feed": {
   "type": "object",
   "properties": {
    "url": {
     "type": "string",
     "format": "uri",
     "maxLength": 500
    },
    "limit": {
     "type": "integer",
     "maximum": 40,
     "minimum": 1
    }
   },
   "additionalProperties": false
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/xml",
      "text/xml"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "country": {
   "type": "string",
   "maxLength": 80
  },
  "notices": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "area": {
      "type": "string",
      "maxLength": 160
     },
     "body": {
      "type": "string",
      "maxLength": 20000
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "title": {
      "type": "string",
      "maxLength": 400
     },
     "agency": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "status": {
      "enum": [
       "allegation",
       "investigation",
       "charge",
       "judgment",
       "penalty",
       "notice",
       "statistic",
       "unknown"
      ],
      "type": "string"
     },
     "country": {
      "type": "string",
      "maxLength": 80
     },
     "sourceUrl": {
      "type": "string",
      "maxLength": 500
     }
    },
    "additionalProperties": false
   },
   "maxItems": 400
  },
  "incidents": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "area": {
      "type": "string",
      "maxLength": 160
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "source": {
      "type": "string",
      "maxLe
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "area": "Downtown",
    "dates": [
     "2026-09-01",
     "2026-09-08"
    ],
    "items": [
     {
      "id": "INC-1",
      "date": "2026-09-01",
      "source": "Caller-supplied blotter",
      "status": "allegation",
      "summary": "Reported theft under investigation",
      "isCharge": false,
      "isNotice": false,
      "isPenalty": false,
      "sourceUrl": "",
      "isJudgment": false,
      "isAllegation": true,
      "guiltInferred": false,
      "isInvestigation": false,
      "chargeTreatedAsConviction": false,
      "allegationTreatedAsJudgment": false,
      "investigationTreatedAsGuilt": false
     },
     {
      "id": "INC-2",
      "date": "2026-09-08",
      "source": "Caller-supplied blotter",
      "status": "allegation",
      "summary": "Another reported theft",
      "isCharge": false,
      "isNotice": false,
      "isPenalty": false,
      "sourceUrl": "",
      "isJudgment": false,
      "isAllegation": true,
      "guiltInferred": false,
      "isInvestigation": false,
      "chargeTreatedAsConviction": false,
      "allegationTreatedAsJudgment": false,
      "investigationTreatedAsGuilt": false
     }
    ],
    "country": "US",
    "offense": "theft",
    "statuses": [
     "allegation"
    ],
    "clusterKey": "theft|downtown",
    "guiltInferred": false,
    "incidentCount": 2,
    "chargeTreatedAsConviction": false,
    "allegationTreatedAsJudgment": false,
    "investigationTreatedAsGuilt": false
   }
  ],
  "status": "clustered",
  "findings": [
   {
    "code": "incident_non_judgment",
    "kind": "observation",
    "detail": "allegation incident is not a finding of guilt.",
    "subject": "INC-1"
   },
   {
    "code": "incident_non_judgment",
    "kind": "observation",
    "detail": "allegation incident is not a finding of guilt.",
    "subject": "INC-2"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "limitations": [
   "Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.",
   "No paid public-records provider is used and no API key is required.",
   "Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.",
   "An allegation, investigation, or charge is never treated as a conviction or final judgment.",
   "Missing counts, penalty amounts, and dispositions ar
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-public-records-incident-cluster-api-2622a8a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
