# BRAINIAC Appointment Cancellation Pattern Detector

> BRAINIAC Appointment Cancellation Pattern Detector 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 records to detect cancellation patterns by weekday, short-notice rates, and provider, returning structured findings and recommendations.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/appointment-intelligence/cancellation-pattern-detect?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-cancellation-pattern-detector-0b4463af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o8edzIDD4j6IheUwtu_b7

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-cancellation-pattern-detector-0b4463af -d '<json body>'
```

Example prompt: Look at this appointment history CSV and detect cancellation patterns — tell me which weekdays have the highest short-notice cancellation rates, flag any appointments cancelled within 2 hours of the start time as short notice, and give me recommendations. Use a minimum sample of 10 appointments per weekday before drawing conclusions.

## When to prefer this

Use this endpoint when you have structured appointment data and need to identify cancellation timing patterns, short-notice rates by weekday or provider, and actionable scheduling policy recommendations — without needing a full analytics platform or BI tool. Prefer this over generic data analysis endpoints when the input is appointment/booking records with statuses and timestamps, and you need compliance-safe, clearly-limited statistical analysis with explicit uncertainty disclosure.

## Known failure modes

- Insufficient appointment data — returns high-uncertainty findings when sample is below minSample
- Missing cancelledAt timestamps — lead hours not computable; leadHoursSupplied will be false
- Malformed date strings in start/end/cancelledAt fields cause parsing failures
- CSV or JSON exceeds 200,000 character limit — request rejected
- More than 500 appointments in the array — excess records truncated or rejected
- Empty appointments array — no patterns can be detected, returns empty items

## 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 containing: per-appointment items with weekday, lead hours, and short-notice flag; aggregated weekday-level cancellation counts and short-notice rates with uncertainty and sample-sufficiency indicators; a list of coded findings (e.g. small sample warnings); actionable recommendations (e.g. review cancellation day, tighten policy); and metadata including checkedAt timestamp, minSample used, and a list of limitations disclosing what the analysis can and cannot infer.

## 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": {
  "items": [
   {
    "id": "A-1",
    "start": "2026-11-03T10:00:00.000Z",
    "service": "",
    "weekday": "tue",
    "leadHours": 2,
    "providerId": "P-1",
    "cancelledAt": "2026-11-03T08:00:00.000Z",
    "shortNotice": true,
    "leadHoursSupplied": true
   },
   {
    "id": "A-2",
    "start": "2026-11-03T14:00:00.000Z",
    "service": "",
    "weekday": "tue",
    "leadHours": 48,
    "providerId": "P-1",
    "cancelledAt": "2026-11-01T14:00:00.000Z",
    "shortNotice": false,
    "leadHoursSupplied": true
   },
   {
    "id": "A-3",
    "start": "2026-11-04T10:00:00.000Z",
    "service": "",
    "weekday": "wed",
    "leadHours": 1,
    "providerId": "P-1",
    "cancelledAt": "2026-11-04T09:00:00.000Z",
    "shortNotice": true,
    "leadHoursSupplied": true
   }
  ],
  "status": "detected",
  "findings": [
   {
    "code": "sample_small",
    "kind": "observation",
    "detail": "Sample size 1 is below the disclosed minimum of 2. Treat the rate as uncertain.",
    "subject": "wed"
   }
  ],
  "weekdays": [
   {
    "weekday": "tue",
    "uncertainty": "observed",
    "shortNoticeRate": 0.5,
    "sampleSufficient": true,
    "shortNoticeCount": 1,
    "cancellationCount": 2,
    "shortNoticeRateSupplied": true
   },
   {
    "weekday": "wed",
    "uncertainty": "high",
    "shortNoticeRate": 1,
    "sampleSufficient": false,
    "shortNoticeCount": 1,
    "cancellationCount": 1,
    "shortNoticeRateSupplied": true
   }
  ],
  "checkedAt": "2026-11-04T18:00:00.000Z",
  "minSample": 2,
  "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."
  ],
  "uncertainty": "observed",
  "reminderSent": false,
  "bookingModified": false,
  "recommendations": [
   {
    "code": "review_cancellation_day",
    "detail": "Observed 2 cancellations on tue. Short-notice share 0.5. This is observed history, not a prediction.",
    "attendancePredicted": false
   },
   {
    "code": "review_short_notice_policy",
    "detail": "Some cancellations occurred under 24 hours before the s
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-appointment-cancellation-pattern-detector-0b4463af/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)
