# BRAINIAC Appointment Intelligence — Capacity Analyze

> BRAINIAC Appointment Intelligence — Capacity Analyze 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).

Analyzes appointment scheduling data to compute provider utilization, detect overbooking, and surface capacity insights across time slots and providers.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/appointment-intelligence/capacity-analyze?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-appointment-intelligence-capacity-analyze-74e6a566
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uNHAP1jWpzsBFQCf05oJV

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-appointment-intelligence-capacity-analyze-74e6a566 -d '<json body>'
```

Example prompt: Can you analyze my appointment data for the week of November 4th and tell me which of my three providers — Dr. Lee (120 min capacity), Dr. Kim (90 min capacity), and Dr. Patel (150 min capacity) — are overbooked or underutilized? I'll paste in the appointment records as a JSON list.

## When to prefer this

Choose this endpoint when you need a structured, AI-ready analysis of appointment capacity and provider utilization from raw scheduling data — especially when you want per-provider overbooked flags and utilization rates without building your own aggregation logic. It supports flexible input formats (JSON, CSV, structured arrays) and explicitly discloses its limitations. Prefer it over general LLM prompting when you need deterministic, auditable capacity metrics with no account setup and pay-per-call pricing via USDC on Base.

## Known failure modes

- Missing required appointment or provider data results in empty or partial findings
- Exceeding maxItems limits (500 appointments, 40 providers, 200 slots) causes request rejection
- Invalid date/time formats in start/end fields may produce incorrect utilization calculations
- Supplying no capacity information results in utilizationSupplied=false and limited output
- Very small sample sizes trigger a small-sample disclosure in limitations
- Malformed base64 file content causes file input to be rejected

## 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 a JSON object with status 'analyzed', per-provider metrics (utilization rate, booked minutes, capacity minutes, appointment count, overbooked flag), a list of findings and observations, a checkedAt timestamp, and a limitations array disclosing what data was and wasn't used. Does not send reminders, modify bookings, predict attendance, or use protected attributes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "slots": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "end": {
      "type": "string",
      "maxLength": 40
     },
     "start": {
      "type": "string",
      "maxLength": 40
     },
     "capacity": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0
     },
     "providerId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "minSample": {
   "type": "integer",
   "maximum": 100000,
   "minimum": 1
  },
  "providers": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "capacityMinutes": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "gapMinutes": {
   "type": "integer",
   "maximum": 1440,
   "minimum": 1
  },
  "appointments": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "end": {
      "type": "string",
      "maxLength": 40
     },
     "start": {
      "type": "string",
      "maxLength": 40
     },
     "status": {
      "type": "string",
      "maxLength": 80
     },
     "channel": {
      "type": "string",
      "maxLength": 80
     },
     "service": {
      "type": "string",
      "maxLength": 160
     },
     "bookedAt": {
      "type": "string",
      "maxLength": 40
     },
     "clientId": {
      "type": "string",
      "maxLength":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "analyzed",
  "findings": [],
  "checkedAt": "2026-11-04T18:00:00.000Z",
  "providers": [
   {
    "name": "Dr Lee",
    "overbooked": false,
    "providerId": "P-1",
    "utilization": 1,
    "bookedMinutes": 120,
    "capacityMinutes": 120,
    "appointmentCount": 2,
    "utilizationSupplied": true,
    "capacityMinutesSupplied": true
   }
  ],
  "limitations": [
   "Appointments, slots, and providers are copied only from labeled fields supplied by the caller.",
   "Attendance, cancellation, and utilization metrics use only those records. Missing times are not invented.",
   "Pattern notes and recommendations describe observed counts. They are not a guarantee of future attendance.",
   "Protected characteristics and sensitive personal attributes are not accepted or used.",
   "No reminder is sent and no booking is modified. Small samples are disclosed."
  ],
  "reminderSent": false,
  "bookingModified": false,
  "attendancePredicted": false,
  "protectedAttributesUsed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-appointment-intelligence-capacity-analyze-74e6a566/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)
