{"uid":"cap_vxAqI1AAYOX9om9VmuWBk","slug":"brainiac-appointment-intelligence-reminder-timing-analyzer-61c2f245","name":"BRAINIAC Appointment Intelligence — Reminder Timing Analyzer","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/reminder-timing-analyze?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":{"items":[{"id":"A-1","start":"2026-11-03T10:00:00.000Z","leadHours":24,"reminderAt":"2026-11-02T10:00:00.000Z","statusKind":"attended","hadReminder":true,"leadHoursSupplied":true,"attendancePredicted":false},{"id":"A-2","start":"2026-11-03T11:00:00.000Z","leadHours":24,"reminderAt":"2026-11-02T11:00:00.000Z","statusKind":"attended","hadReminder":true,"leadHoursSupplied":true,"attendancePredicted":false},{"id":"A-3","start":"2026-11-03T12:00:00.000Z","leadHours":6,"reminderAt":"2026-11-03T06:00:00.000Z","statusKind":"no_show","hadReminder":true,"leadHoursSupplied":true,"attendancePredicted":false},{"id":"A-4","start":"2026-11-03T13:00:00.000Z","leadHours":5,"reminderAt":"2026-11-03T08:00:00.000Z","statusKind":"no_show","hadReminder":true,"leadHoursSupplied":true,"attendancePredicted":false}],"status":"analyzed","timings":[{"label":"under_12h","noShowRate":1,"noShowCount":2,"uncertainty":"observed","decidedCount":2,"appointmentCount":2,"sampleSufficient":true,"noShowRateSupplied":true,"attendancePredicted":false},{"label":"12h_to_24h","noShowRate":0,"noShowCount":0,"uncertainty":"high","decidedCount":0,"appointmentCount":0,"sampleSufficient":false,"noShowRateSupplied":false,"attendancePredicted":false},{"label":"24h_to_48h","noShowRate":0,"noShowCount":0,"uncertainty":"observed","decidedCount":2,"appointmentCount":2,"sampleSufficient":true,"noShowRateSupplied":true,"attendancePredicted":false},{"label":"over_48h","noShowRate":0,"noShowCount":0,"uncertainty":"high","decidedCount":0,"appointmentCount":0,"sampleSufficient":false,"noShowRateSupplied":false,"attendancePredicted":false}],"findings":[{"code":"reminder_absent","kind":"observation","detail":"No reminder timestamp was supplied for this appointment.","subject":"A-5"}],"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."],"reminderSent":false,"bookingModified":false,"recommendations":[{"code":"compare_reminder_windows","detail":"Among reminder windows with sufficient samples, 24h_to_48h had the lowest observed no-show rate (0) and under_12h had the highest (1). This is an association in the supplied history, not proof that timing causes attendance.","attendancePredicted":false},{"code":"no_send","detail":"No reminder was sent by this endpoint. Timing analysis uses supplied reminder timestamps only.","attendancePredicted":false}],"withReminderCount":4,"attendancePredicted":false,"withoutReminderCount":1,"protectedAttributesUsed":false}},"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_QSiqDA2vMXSDyEe933EEA","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":"Analyzes appointment history to determine which reminder lead times (e.g. 24h, under 12h) correlate with attendance vs. no-show rates, flagging optimal reminder windows.","exampleAgentPrompt":"I have appointment records from the past 6 months — can you analyze whether our 24-hour reminders actually reduce no-shows compared to same-day reminders, using at least 10 appointments per bucket as the minimum sample?","exampleUseCases":[{"title":"Optimize clinic reminder policy","prompt":"Here are 300 appointments from our medical clinic over the last quarter, including when each reminder was sent and whether the patient showed up. Analyze which reminder lead times — like under 12 hours, 24 hours, or over 48 hours — actually reduce no-shows, and flag any appointments that had no reminder at all. Use a minimum sample of 20 per timing bucket."},{"title":"Evaluate salon booking reminder effectiveness","prompt":"I run a hair salon and I want to know if our reminder timing is working. Here's a CSV of our last 500 bookings with reminder timestamps, start times, and whether clients showed up or cancelled. Can you break down no-show rates by how far in advance we sent the reminder?"},{"title":"Identify no-show risk windows for a scheduling agent","prompt":"Before we build an automated reminder system, I need to know which timing windows have the worst no-show rates in our existing data. Here's a JSON list of 200 past appointments with their statuses, reminder times, and provider IDs — analyze the timing buckets and tell me which ones are most problematic, using at least 15 appointments as the minimum reliable sample."}],"resultDescription":"Returns a JSON object with: (1) per-appointment records showing reminder lead hours, attendance outcome, and whether a reminder was supplied; (2) timing bucket summaries (under_12h, 12h_to_24h, 24h_to_48h, over_48h) with no-show rates, counts, uncertainty level, and sample sufficiency flags; (3) findings list with observations like missing reminders; (4) metadata including analysis timestamp, minimum sample threshold used, and known limitations.","failureModes":["Insufficient appointment data — buckets with fewer appointments than minSample receive 'high' uncertainty and no no-show rate is computed","Missing reminder timestamps — appointments without reminderAt are flagged in findings as 'reminder_absent'","Ambiguous or malformed datetime strings in start/end/reminderAt fields may cause parsing errors","Exceeding maxItems (500 appointments, 200 slots, 40 providers) causes input rejection","CSV/JSON/text inputs exceeding 200,000 character limit are rejected","No attended/no-show statuses resolvable — if all statuses are unrecognized, analysis may return empty timing data"],"whenToPreferThis":"Use this endpoint when you have historical appointment data with reminder timestamps and want to empirically determine which reminder lead-time windows correlate with better attendance — especially useful before building or tuning an automated reminder system. Prefer this over generic analytics when you need structured timing-bucket analysis (under 12h, 12–24h, 24–48h, 48h+) with uncertainty flags and sample sufficiency scoring. It is not a scheduling or reminder-sending tool — it only analyzes past data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:35:19.833Z","isFirstParty":false,"canonicalSlug":"brainiac-appointment-intelligence-reminder-timing-analyzer-61c2f245"}