{"uid":"cap_s79c4UlYk-c2UA485iv3l","slug":"brainiac-schedule-utilization-calculator-e851cf1d","name":"BRAINIAC Schedule Utilization Calculator","description":"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.","url":"https://www.brainiac.software/api/v1/appointment-intelligence/schedule-utilization-calculate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":80},"providerId":{"type":"string","maxLength":80},"reminderAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"type":"json","example":{"status":"calculated","findings":[],"checkedAt":"2026-11-04T18:00:00.000Z","providers":[{"name":"Dr Lee","overbooked":false,"providerId":"P-1","utilization":0.5,"bookedMinutes":120,"capacityMinutes":240,"appointmentCount":3,"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,"bookedMinutes":120,"attendedMinutes":60,"bookingModified":false,"capacityMinutes":240,"recommendations":[{"code":"fill_open_capacity","detail":"Observed schedule utilization 0.5 from supplied bookings and capacity. Consider opening booking for unused capacity. This is not a demand forecast.","attendancePredicted":false}],"attendancePredicted":false,"scheduleUtilization":0.5,"attendanceUtilization":0.25,"capacityMinutesSupplied":true,"protectedAttributesUsed":false,"scheduleUtilizationSupplied":true,"attendanceUtilizationSupplied":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oTCsG4j5Cg8F0yWBfq9k6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates appointment schedule utilization metrics (booked vs. capacity) and attendance rates for healthcare or service providers, returning recommendations for filling unused capacity.","exampleAgentPrompt":"Can you calculate the schedule utilization for my clinic as of today? Here are the appointments and provider schedules — Dr. Lee has 240 minutes of capacity and 120 minutes booked, with 60 minutes of attended time. Flag any recommendations for filling open slots.","exampleUseCases":[{"title":"Clinic weekly utilization review","prompt":"Calculate schedule utilization for my medical clinic as of this Friday. I have three providers — Dr. Lee with 240 capacity minutes, Dr. Patel with 300, and Dr. Kim with 200. Here's the appointment CSV with all bookings and statuses for the week. Tell me who has open capacity I should be filling."},{"title":"Single provider efficiency audit","prompt":"I want to know how efficiently Dr. Rivera's schedule is being used this month. She has 480 capacity minutes per day and I have 150 appointments in JSON format with start times, end times, and attendance status. Can you calculate her booked and attended utilization and flag any patterns?"},{"title":"Multi-provider spa capacity planning","prompt":"Run a schedule utilization report for my day spa as of November 4th. I'll paste in the appointment JSON — 4 providers each with 360 minutes of daily capacity. I need to know the overall utilization rate and which providers have consistently low bookings so we can open those slots to walk-ins."}],"resultDescription":"Returns a JSON object with overall schedule utilization ratio (booked/capacity), attendance utilization ratio (attended/capacity), total booked and attended minutes, per-provider breakdowns with utilization rates and appointment counts, actionable recommendations (e.g., fill open capacity), findings, limitations disclosures, and flags for whether attendance was predicted or actual and whether protected attributes were used.","failureModes":["Missing required appointment data — no appointments, slots, or providers supplied returns empty or limited results","Insufficient sample size below minSample threshold triggers disclosure warning","Appointments with missing start/end times are excluded without being invented","Malformed date strings in start/end/asOf fields may cause parsing errors","CSV or JSON payload exceeding 200,000 character limit rejected","Slots array exceeding 200 items or providers array exceeding 40 items rejected"],"whenToPreferThis":"Use this endpoint when you need deterministic, auditable utilization metrics computed from actual appointment records — not predictions or forecasts. Ideal when you have structured appointment data (JSON, CSV, or raw arrays) and want per-provider breakdowns with capacity vs. booked vs. attended minutes. Prefer this over general analytics tools when you need compliance-safe computation (no protected attributes used, no data retained) and transparent limitation disclosures. Best for healthcare practices, service businesses, or any scheduling-heavy operation needing a one-shot utilization snapshot paid per-call without an account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:49.371Z","isFirstParty":false,"canonicalSlug":"brainiac-schedule-utilization-calculator-e851cf1d"}