# BRAINIAC Appointment Booking Gap Detector

> BRAINIAC Appointment Booking Gap 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 a list of appointments and time slots to identify scheduling gaps above a specified threshold between consecutive non-cancelled bookings, per provider.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/appointment-intelligence/booking-gap-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-booking-gap-detector-06aaab85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vdPMMiXBN3QE3cuwHe4Gr

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-booking-gap-detector-06aaab85 -d '<json body>'
```

Example prompt: Look through this list of appointments for provider P-1 and flag any gaps of at least 30 minutes between consecutive non-cancelled bookings — here's the appointment data as JSON.

## When to prefer this

Use this endpoint when you need a lightweight, no-account, pay-per-call analysis of scheduling gaps in an existing appointment dataset — especially for service businesses (clinics, salons, consultancies) or automated agent workflows that need to detect open provider windows without modifying any bookings or sending reminders. Prefer this over building custom gap detection logic when the appointment data is already structured or can be passed as CSV/JSON.

## Known failure modes

- Insufficient appointment data — returns empty gaps list if no consecutive non-cancelled appointments exist
- Missing required time fields (start/end) on appointment records — those records are skipped
- gapMinutes not provided — defaults or errors depending on implementation
- Input exceeds maxItems (500 appointments, 200 slots, 40 providers) — oversized payloads may be rejected
- Malformed datetime strings in start/end/asOf fields — parsing errors may cause incorrect or empty results
- Small sample size disclosed in limitations but not blocked

## 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: a list of detected gaps (each with fromId, toId, fromEnd, toStart, gapMinutes, providerId, and thresholdMinutes), total gap count, the gap threshold used, the timestamp checked, recommendations (e.g. reviewing open gaps for rebooking), and explicit limitations (no predictions, no reminders sent, no bookings modified). Also confirms that no protected attributes were used and no side effects occurred.

## 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": {
  "gaps": [
   {
    "toId": "A-2",
    "fromId": "A-1",
    "fromEnd": "2026-11-03T09:30:00.000Z",
    "toStart": "2026-11-03T11:00:00.000Z",
    "gapMinutes": 90,
    "providerId": "P-1",
    "thresholdMinutes": 30
   }
  ],
  "status": "detected",
  "findings": [],
  "gapCount": 1,
  "checkedAt": "2026-11-04T18:00:00.000Z",
  "gapMinutes": 30,
  "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,
  "recommendations": [
   {
    "code": "review_open_gaps",
    "detail": "Found 1 gap(s) of at least 30 minutes between consecutive non-cancelled appointments. Consider offering those windows if staffing allows. This is not a demand forecast.",
    "attendancePredicted": false
   }
  ],
  "attendancePredicted": false,
  "protectedAttributesUsed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-appointment-booking-gap-detector-06aaab85/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)
