{"uid":"cap_vdPMMiXBN3QE3cuwHe4Gr","slug":"brainiac-appointment-booking-gap-detector-06aaab85","name":"BRAINIAC Appointment Booking Gap Detector","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/booking-gap-detect?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":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c0CiPHak7MGl1vu9fXz7p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a list of appointments and time slots to identify scheduling gaps above a specified threshold between consecutive non-cancelled bookings, per provider.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Clinic schedule gap audit","prompt":"I have a list of 50 appointments for three doctors this week — can you check for any gaps of 45 minutes or more between consecutive non-cancelled bookings for each provider and tell me which windows are open?"},{"title":"Salon provider utilization review","prompt":"Here's a CSV of all our stylist appointments from last month. Find any scheduling gaps longer than 60 minutes between back-to-back bookings for each stylist so we can see where we're losing time."},{"title":"Automated booking gap alert for agent","prompt":"Every morning, run this appointment dataset through the gap detector with a 30-minute threshold and let me know if any provider has open windows that could be offered to waiting clients."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:54.748Z","isFirstParty":false,"canonicalSlug":"brainiac-appointment-booking-gap-detector-06aaab85"}