{"openapi":"3.1.0","info":{"title":"Appointment Intelligence API","version":"1.0.0","description":"Read supplied appointment histories and schedule exports to measure no-shows, cancellations, and utilization without sending reminders or changing bookings. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/appointment-intelligence/data-normalize":{"post":{"operationId":"normalize_appointment_data","summary":"Normalize appointment data","description":"Copy supplied appointments, slots, and providers into a consistent inventory with status kinds and durations. Protected attributes are not accepted. No booking is modified.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"text":"Appointment: A-1 | C-1 | P-1 | consult | 2026-11-03T10:00:00.000Z | 2026-11-03T10:30:00.000Z | attended | 2026-11-01T09:00:00.000Z | | 2026-11-02T10:00:00.000Z | phone\nProvider: P-1 | Dr Lee | 480\nPredict by ethnicity.\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"appointments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"clientId":{"type":"string"},"providerId":{"type":"string"},"service":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"status":{"type":"string"},"statusKind":{"type":"string"},"bookedAt":{"type":"string"},"cancelledAt":{"type":"string"},"reminderAt":{"type":"string"},"channel":{"type":"string"},"durationMinutes":{"type":"number"},"durationMinutesSupplied":{"type":"boolean"},"weekday":{"type":"string"},"hour":{"type":"number"},"hourSupplied":{"type":"boolean"}},"additionalProperties":true}},"slots":{"type":"array","items":{}},"providers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"normalized","appointments":[{"id":"A-1","clientId":"C-1","providerId":"P-1","service":"consult","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"attended","statusKind":"attended","bookedAt":"2026-11-01T09:00:00.000Z","cancelledAt":"","reminderAt":"2026-11-02T10:00:00.000Z","channel":"phone","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"tue","hour":10,"hourSupplied":true}],"slots":[],"providers":[{"id":"P-1","name":"Dr Lee","capacityMinutes":480,"capacityMinutesSupplied":true}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[{"kind":"ignored","code":"unlabeled_line","subject":"","detail":"Lines without a recognized label were not read and their text was not copied."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/no-show-analyze":{"post":{"operationId":"analyze_appointment_no_shows","summary":"Analyze appointment no-shows","description":"Calculate no-show rates by weekday, hour, and repeat client id from supplied history. Small samples are disclosed. Attendance is not predicted from protected attributes.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"minSample":3,"appointments":[{"id":"A-1","clientId":"C-1","providerId":"P-1","start":"2026-11-02T10:00:00.000Z","end":"2026-11-02T10:30:00.000Z","status":"no-show"},{"id":"A-2","clientId":"C-1","providerId":"P-1","start":"2026-11-09T10:00:00.000Z","end":"2026-11-09T10:30:00.000Z","status":"no-show"},{"id":"A-3","clientId":"C-2","providerId":"P-1","start":"2026-11-02T11:00:00.000Z","end":"2026-11-02T11:30:00.000Z","status":"attended"},{"id":"A-4","clientId":"C-3","providerId":"P-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"attended"},{"id":"A-5","clientId":"C-4","providerId":"P-1","start":"2026-11-03T11:00:00.000Z","end":"2026-11-03T11:30:00.000Z","status":"attended"},{"id":"A-6","clientId":"C-5","providerId":"P-1","start":"2026-11-03T15:00:00.000Z","end":"2026-11-03T15:30:00.000Z","status":"attended"},{"id":"A-7","clientId":"C-6","providerId":"P-1","start":"2026-11-02T15:00:00.000Z","end":"2026-11-02T15:30:00.000Z","status":"no-show"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"minSample":{"type":"number"},"decidedCount":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"weekdays":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"string"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"hours":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"number"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"repeatClients":{"type":"array","items":{"type":"object","properties":{"clientId":{"type":"string"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"sampleSufficient":{"type":"boolean"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"analyzed","minSample":3,"decidedCount":7,"noShowCount":3,"noShowRate":0.4286,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","weekdays":[{"weekday":"mon","total":4,"noShowCount":3,"noShowRate":0.75,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"weekday":"tue","total":3,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false}],"hours":[{"hour":10,"total":3,"noShowCount":2,"noShowRate":0.6667,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"hour":15,"total":2,"noShowCount":1,"noShowRate":0.5,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"hour":11,"total":2,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false}],"repeatClients":[{"clientId":"C-1","total":2,"noShowCount":2,"noShowRate":1,"sampleSufficient":false,"attendancePredicted":false}],"recommendations":[{"code":"review_weekday","detail":"Observed no-show rate 0.75 on mon across 4 decided appointments. Consider reviewing reminder timing for that day. This is not a prediction.","attendancePredicted":false},{"code":"review_hour","detail":"Observed no-show rate 0.6667 at hour 10 UTC across 3 decided appointments. This is an observed pattern, not a forecast.","attendancePredicted":false},{"code":"review_repeat_no_show","detail":"1 client id(s) have two or more recorded no-shows in the supplied history. Review booking policy using those counts only.","attendancePredicted":false}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/cancellation-pattern-detect":{"post":{"operationId":"detect_cancellation_patterns","summary":"Detect cancellation patterns","description":"Find cancellations, short-notice lead times, and weekday patterns from supplied timestamps. Small samples are disclosed.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"minSample":2,"appointments":[{"id":"A-1","providerId":"P-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"cancelled","cancelledAt":"2026-11-03T08:00:00.000Z"},{"id":"A-2","providerId":"P-1","start":"2026-11-03T14:00:00.000Z","end":"2026-11-03T14:30:00.000Z","status":"cancelled","cancelledAt":"2026-11-01T14:00:00.000Z"},{"id":"A-3","providerId":"P-1","start":"2026-11-04T10:00:00.000Z","end":"2026-11-04T10:30:00.000Z","status":"cancelled","cancelledAt":"2026-11-04T09:00:00.000Z"},{"id":"A-4","providerId":"P-1","start":"2026-11-04T11:00:00.000Z","end":"2026-11-04T11:30:00.000Z","status":"attended"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"minSample":{"type":"number"},"cancellationCount":{"type":"number"},"shortNoticeCount":{"type":"number"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"providerId":{"type":"string"},"service":{"type":"string"},"start":{"type":"string"},"cancelledAt":{"type":"string"},"weekday":{"type":"string"},"leadHours":{"type":"number"},"leadHoursSupplied":{"type":"boolean"},"shortNotice":{"type":"boolean"}},"additionalProperties":true}},"weekdays":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"string"},"cancellationCount":{"type":"number"},"shortNoticeCount":{"type":"number"},"shortNoticeRate":{"type":"number"},"shortNoticeRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"detected","minSample":2,"cancellationCount":3,"shortNoticeCount":2,"sampleSufficient":true,"uncertainty":"observed","items":[{"id":"A-1","providerId":"P-1","service":"","start":"2026-11-03T10:00:00.000Z","cancelledAt":"2026-11-03T08:00:00.000Z","weekday":"tue","leadHours":2,"leadHoursSupplied":true,"shortNotice":true},{"id":"A-2","providerId":"P-1","service":"","start":"2026-11-03T14:00:00.000Z","cancelledAt":"2026-11-01T14:00:00.000Z","weekday":"tue","leadHours":48,"leadHoursSupplied":true,"shortNotice":false},{"id":"A-3","providerId":"P-1","service":"","start":"2026-11-04T10:00:00.000Z","cancelledAt":"2026-11-04T09:00:00.000Z","weekday":"wed","leadHours":1,"leadHoursSupplied":true,"shortNotice":true}],"weekdays":[{"weekday":"tue","cancellationCount":2,"shortNoticeCount":1,"shortNoticeRate":0.5,"shortNoticeRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed"},{"weekday":"wed","cancellationCount":1,"shortNoticeCount":1,"shortNoticeRate":1,"shortNoticeRateSupplied":true,"sampleSufficient":false,"uncertainty":"high"}],"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 start time in the supplied timestamps.","attendancePredicted":false}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[{"kind":"observation","code":"sample_small","subject":"wed","detail":"Sample size 1 is below the disclosed minimum of 2. Treat the rate as uncertain."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/capacity-analyze":{"post":{"operationId":"analyze_appointment_capacity","summary":"Analyze appointment capacity","description":"Compare booked appointment minutes with supplied provider capacity or slots. Overbooking is reported from those numbers only.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"providers":[{"id":"P-1","name":"Dr Lee","capacityMinutes":120}],"appointments":[{"id":"A-1","providerId":"P-1","start":"2026-11-03T09:00:00.000Z","end":"2026-11-03T10:00:00.000Z","status":"attended"},{"id":"A-2","providerId":"P-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T11:00:00.000Z","status":"booked"},{"id":"A-3","providerId":"P-1","start":"2026-11-03T11:00:00.000Z","end":"2026-11-03T11:30:00.000Z","status":"cancelled"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"providers":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"name":{"type":"string"},"bookedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"appointmentCount":{"type":"number"},"utilization":{"type":"number"},"utilizationSupplied":{"type":"boolean"},"overbooked":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"analyzed","providers":[{"providerId":"P-1","name":"Dr Lee","bookedMinutes":120,"capacityMinutes":120,"capacityMinutesSupplied":true,"appointmentCount":2,"utilization":1,"utilizationSupplied":true,"overbooked":false}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/schedule-utilization-calculate":{"post":{"operationId":"calculate_schedule_utilization","summary":"Calculate schedule utilization","description":"Calculate schedule and attendance utilization from supplied bookings and capacity. Recommendations describe observed fill levels only.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"providers":[{"id":"P-1","name":"Dr Lee","capacityMinutes":240}],"appointments":[{"id":"A-1","providerId":"P-1","start":"2026-11-03T09:00:00.000Z","end":"2026-11-03T10:00:00.000Z","status":"attended"},{"id":"A-2","providerId":"P-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"no-show"},{"id":"A-3","providerId":"P-1","start":"2026-11-03T11:00:00.000Z","end":"2026-11-03T11:30:00.000Z","status":"booked"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"bookedMinutes":{"type":"number"},"attendedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"scheduleUtilization":{"type":"number"},"scheduleUtilizationSupplied":{"type":"boolean"},"attendanceUtilization":{"type":"number"},"attendanceUtilizationSupplied":{"type":"boolean"},"providers":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"name":{"type":"string"},"bookedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"appointmentCount":{"type":"number"},"utilization":{"type":"number"},"utilizationSupplied":{"type":"boolean"},"overbooked":{"type":"boolean"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"calculated","bookedMinutes":120,"attendedMinutes":60,"capacityMinutes":240,"capacityMinutesSupplied":true,"scheduleUtilization":0.5,"scheduleUtilizationSupplied":true,"attendanceUtilization":0.25,"attendanceUtilizationSupplied":true,"providers":[{"providerId":"P-1","name":"Dr Lee","bookedMinutes":120,"capacityMinutes":240,"capacityMinutesSupplied":true,"appointmentCount":3,"utilization":0.5,"utilizationSupplied":true,"overbooked":false}],"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}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/booking-gap-detect":{"post":{"operationId":"detect_booking_gaps","summary":"Detect booking gaps","description":"Find gaps of at least the disclosed minute threshold between consecutive non-cancelled appointments for each provider.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"gapMinutes":30,"appointments":[{"id":"A-1","providerId":"P-1","start":"2026-11-03T09:00:00.000Z","end":"2026-11-03T09:30:00.000Z","status":"attended"},{"id":"A-2","providerId":"P-1","start":"2026-11-03T11:00:00.000Z","end":"2026-11-03T11:30:00.000Z","status":"booked"},{"id":"A-3","providerId":"P-1","start":"2026-11-03T11:30:00.000Z","end":"2026-11-03T12:00:00.000Z","status":"booked"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"gapMinutes":{"type":"number"},"gapCount":{"type":"number"},"gaps":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"fromId":{"type":"string"},"toId":{"type":"string"},"fromEnd":{"type":"string"},"toStart":{"type":"string"},"gapMinutes":{"type":"number"},"thresholdMinutes":{"type":"number"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"detected","gapMinutes":30,"gapCount":1,"gaps":[{"providerId":"P-1","fromId":"A-1","toId":"A-2","fromEnd":"2026-11-03T09:30:00.000Z","toStart":"2026-11-03T11:00:00.000Z","gapMinutes":90,"thresholdMinutes":30}],"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}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/reminder-timing-analyze":{"post":{"operationId":"analyze_appointment_reminder_timing","summary":"Analyze appointment reminder timing","description":"Compare observed no-show rates across reminder lead-time windows from supplied reminder timestamps. No reminder is sent.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"minSample":2,"appointments":[{"id":"A-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"attended","reminderAt":"2026-11-02T10:00:00.000Z"},{"id":"A-2","start":"2026-11-03T11:00:00.000Z","end":"2026-11-03T11:30:00.000Z","status":"attended","reminderAt":"2026-11-02T11:00:00.000Z"},{"id":"A-3","start":"2026-11-03T12:00:00.000Z","end":"2026-11-03T12:30:00.000Z","status":"no-show","reminderAt":"2026-11-03T06:00:00.000Z"},{"id":"A-4","start":"2026-11-03T13:00:00.000Z","end":"2026-11-03T13:30:00.000Z","status":"no-show","reminderAt":"2026-11-03T08:00:00.000Z"},{"id":"A-5","start":"2026-11-03T14:00:00.000Z","end":"2026-11-03T14:30:00.000Z","status":"attended"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"minSample":{"type":"number"},"withReminderCount":{"type":"number"},"withoutReminderCount":{"type":"number"},"timings":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"appointmentCount":{"type":"number"},"decidedCount":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"statusKind":{"type":"string"},"start":{"type":"string"},"reminderAt":{"type":"string"},"leadHours":{"type":"number"},"leadHoursSupplied":{"type":"boolean"},"hadReminder":{"type":"boolean"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"analyzed","minSample":2,"withReminderCount":4,"withoutReminderCount":1,"timings":[{"label":"under_12h","appointmentCount":2,"decidedCount":2,"noShowCount":2,"noShowRate":1,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"label":"12h_to_24h","appointmentCount":0,"decidedCount":0,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":false,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"label":"24h_to_48h","appointmentCount":2,"decidedCount":2,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"label":"over_48h","appointmentCount":0,"decidedCount":0,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":false,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false}],"items":[{"id":"A-1","statusKind":"attended","start":"2026-11-03T10:00:00.000Z","reminderAt":"2026-11-02T10:00:00.000Z","leadHours":24,"leadHoursSupplied":true,"hadReminder":true,"attendancePredicted":false},{"id":"A-2","statusKind":"attended","start":"2026-11-03T11:00:00.000Z","reminderAt":"2026-11-02T11:00:00.000Z","leadHours":24,"leadHoursSupplied":true,"hadReminder":true,"attendancePredicted":false},{"id":"A-3","statusKind":"no_show","start":"2026-11-03T12:00:00.000Z","reminderAt":"2026-11-03T06:00:00.000Z","leadHours":6,"leadHoursSupplied":true,"hadReminder":true,"attendancePredicted":false},{"id":"A-4","statusKind":"no_show","start":"2026-11-03T13:00:00.000Z","reminderAt":"2026-11-03T08:00:00.000Z","leadHours":5,"leadHoursSupplied":true,"hadReminder":true,"attendancePredicted":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}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[{"kind":"observation","code":"reminder_absent","subject":"A-5","detail":"No reminder timestamp was supplied for this appointment."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/appointment-intelligence/operations-report":{"post":{"operationId":"report_appointment_operations","summary":"Report appointment operations","description":"Combine no-show patterns, cancellations, capacity, utilization, gaps, and reminder timing from supplied schedules. No reminder is sent and attendance is not predicted.","tags":["appointment-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"appointments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"clientId":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"service":{"type":"string","maxLength":160},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"bookedAt":{"type":"string","maxLength":40},"cancelledAt":{"type":"string","maxLength":40},"reminderAt":{"type":"string","maxLength":40},"channel":{"type":"string","maxLength":80}},"additionalProperties":false}},"slots":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"providerId":{"type":"string","maxLength":80},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"capacity":{"type":"number","minimum":0,"maximum":10000}},"additionalProperties":false}},"providers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"capacityMinutes":{"type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"minSample":{"type":"integer","minimum":1,"maximum":100000},"gapMinutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false},"example":{"minSample":3,"gapMinutes":30,"providers":[{"id":"P-1","name":"Dr Lee","capacityMinutes":300}],"appointments":[{"id":"A-1","clientId":"C-1","providerId":"P-1","start":"2026-11-02T10:00:00.000Z","end":"2026-11-02T10:30:00.000Z","status":"no-show","reminderAt":"2026-11-02T04:00:00.000Z"},{"id":"A-2","clientId":"C-1","providerId":"P-1","start":"2026-11-09T10:00:00.000Z","end":"2026-11-09T10:30:00.000Z","status":"no-show","reminderAt":"2026-11-09T04:00:00.000Z"},{"id":"A-3","clientId":"C-2","providerId":"P-1","start":"2026-11-02T11:00:00.000Z","end":"2026-11-02T11:30:00.000Z","status":"attended","reminderAt":"2026-11-01T11:00:00.000Z"},{"id":"A-4","clientId":"C-3","providerId":"P-1","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"attended","reminderAt":"2026-11-02T10:00:00.000Z"},{"id":"A-5","clientId":"C-4","providerId":"P-1","start":"2026-11-03T14:00:00.000Z","end":"2026-11-03T14:30:00.000Z","status":"cancelled","cancelledAt":"2026-11-03T08:00:00.000Z"},{"id":"A-6","clientId":"C-5","providerId":"P-1","start":"2026-11-03T16:00:00.000Z","end":"2026-11-03T16:30:00.000Z","status":"booked"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"minSample":{"type":"number"},"gapMinutes":{"type":"number"},"appointmentCount":{"type":"number"},"noShowCount":{"type":"number"},"cancellationCount":{"type":"number"},"gapCount":{"type":"number"},"scheduleUtilization":{"type":"number"},"scheduleUtilizationSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"appointments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"clientId":{"type":"string"},"providerId":{"type":"string"},"service":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"status":{"type":"string"},"statusKind":{"type":"string"},"bookedAt":{"type":"string"},"cancelledAt":{"type":"string"},"reminderAt":{"type":"string"},"channel":{"type":"string"},"durationMinutes":{"type":"number"},"durationMinutesSupplied":{"type":"boolean"},"weekday":{"type":"string"},"hour":{"type":"number"},"hourSupplied":{"type":"boolean"}},"additionalProperties":true}},"noShow":{"type":"object","properties":{"status":{"type":"string"},"minSample":{"type":"number"},"decidedCount":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"weekdays":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"string"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"hours":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"number"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"repeatClients":{"type":"array","items":{"type":"object","properties":{"clientId":{"type":"string"},"total":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"sampleSufficient":{"type":"boolean"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"cancellations":{"type":"object","properties":{"cancellationCount":{"type":"number"},"shortNoticeCount":{"type":"number"},"weekdays":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"string"},"cancellationCount":{"type":"number"},"shortNoticeCount":{"type":"number"},"shortNoticeRate":{"type":"number"},"shortNoticeRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"}},"additionalProperties":true}},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"}},"additionalProperties":true},"capacity":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"name":{"type":"string"},"bookedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"appointmentCount":{"type":"number"},"utilization":{"type":"number"},"utilizationSupplied":{"type":"boolean"},"overbooked":{"type":"boolean"}},"additionalProperties":true}},"utilization":{"type":"object","properties":{"status":{"type":"string"},"bookedMinutes":{"type":"number"},"attendedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"scheduleUtilization":{"type":"number"},"scheduleUtilizationSupplied":{"type":"boolean"},"attendanceUtilization":{"type":"number"},"attendanceUtilizationSupplied":{"type":"boolean"},"providers":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"name":{"type":"string"},"bookedMinutes":{"type":"number"},"capacityMinutes":{"type":"number"},"capacityMinutesSupplied":{"type":"boolean"},"appointmentCount":{"type":"number"},"utilization":{"type":"number"},"utilizationSupplied":{"type":"boolean"},"overbooked":{"type":"boolean"}},"additionalProperties":true}},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"findings":{"type":"array","items":{}}},"additionalProperties":true},"gaps":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"fromId":{"type":"string"},"toId":{"type":"string"},"fromEnd":{"type":"string"},"toStart":{"type":"string"},"gapMinutes":{"type":"number"},"thresholdMinutes":{"type":"number"}},"additionalProperties":true}},"reminders":{"type":"object","properties":{"withReminderCount":{"type":"number"},"withoutReminderCount":{"type":"number"},"timings":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"appointmentCount":{"type":"number"},"decidedCount":{"type":"number"},"noShowCount":{"type":"number"},"noShowRate":{"type":"number"},"noShowRateSupplied":{"type":"boolean"},"sampleSufficient":{"type":"boolean"},"uncertainty":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}}},"additionalProperties":true},"recommendations":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"attendancePredicted":{"type":"boolean"}},"additionalProperties":true}},"reminderSent":{"type":"boolean"},"bookingModified":{"type":"boolean"},"protectedAttributesUsed":{"type":"boolean"},"attendancePredicted":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T18:00:00.000Z","status":"reported","minSample":3,"gapMinutes":30,"appointmentCount":6,"noShowCount":2,"cancellationCount":1,"gapCount":4,"scheduleUtilization":0.5,"scheduleUtilizationSupplied":true,"sampleSufficient":true,"uncertainty":"observed","appointments":[{"id":"A-1","clientId":"C-1","providerId":"P-1","service":"","start":"2026-11-02T10:00:00.000Z","end":"2026-11-02T10:30:00.000Z","status":"no-show","statusKind":"no_show","bookedAt":"","cancelledAt":"","reminderAt":"2026-11-02T04:00:00.000Z","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"mon","hour":10,"hourSupplied":true},{"id":"A-2","clientId":"C-1","providerId":"P-1","service":"","start":"2026-11-09T10:00:00.000Z","end":"2026-11-09T10:30:00.000Z","status":"no-show","statusKind":"no_show","bookedAt":"","cancelledAt":"","reminderAt":"2026-11-09T04:00:00.000Z","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"mon","hour":10,"hourSupplied":true},{"id":"A-3","clientId":"C-2","providerId":"P-1","service":"","start":"2026-11-02T11:00:00.000Z","end":"2026-11-02T11:30:00.000Z","status":"attended","statusKind":"attended","bookedAt":"","cancelledAt":"","reminderAt":"2026-11-01T11:00:00.000Z","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"mon","hour":11,"hourSupplied":true},{"id":"A-4","clientId":"C-3","providerId":"P-1","service":"","start":"2026-11-03T10:00:00.000Z","end":"2026-11-03T10:30:00.000Z","status":"attended","statusKind":"attended","bookedAt":"","cancelledAt":"","reminderAt":"2026-11-02T10:00:00.000Z","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"tue","hour":10,"hourSupplied":true},{"id":"A-5","clientId":"C-4","providerId":"P-1","service":"","start":"2026-11-03T14:00:00.000Z","end":"2026-11-03T14:30:00.000Z","status":"cancelled","statusKind":"cancelled","bookedAt":"","cancelledAt":"2026-11-03T08:00:00.000Z","reminderAt":"","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"tue","hour":14,"hourSupplied":true},{"id":"A-6","clientId":"C-5","providerId":"P-1","service":"","start":"2026-11-03T16:00:00.000Z","end":"2026-11-03T16:30:00.000Z","status":"booked","statusKind":"booked","bookedAt":"","cancelledAt":"","reminderAt":"","channel":"","durationMinutes":30,"durationMinutesSupplied":true,"weekday":"tue","hour":16,"hourSupplied":true}],"noShow":{"status":"analyzed","minSample":3,"decidedCount":5,"noShowCount":2,"noShowRate":0.4,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","weekdays":[{"weekday":"mon","total":3,"noShowCount":2,"noShowRate":0.6667,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"weekday":"tue","total":2,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false}],"hours":[{"hour":10,"total":3,"noShowCount":2,"noShowRate":0.6667,"noShowRateSupplied":true,"sampleSufficient":true,"uncertainty":"observed","attendancePredicted":false},{"hour":11,"total":1,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"hour":14,"total":1,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false}],"repeatClients":[{"clientId":"C-1","total":2,"noShowCount":2,"noShowRate":1,"sampleSufficient":false,"attendancePredicted":false}],"recommendations":[{"code":"review_weekday","detail":"Observed no-show rate 0.6667 on mon across 3 decided appointments. Consider reviewing reminder timing for that day. This is not a prediction.","attendancePredicted":false},{"code":"review_hour","detail":"Observed no-show rate 0.6667 at hour 10 UTC across 3 decided appointments. This is an observed pattern, not a forecast.","attendancePredicted":false},{"code":"review_repeat_no_show","detail":"1 client id(s) have two or more recorded no-shows in the supplied history. Review booking policy using those counts only.","attendancePredicted":false}],"findings":[{"kind":"observation","code":"sample_small","subject":"tue","detail":"Sample size 2 is below the disclosed minimum of 3. Treat the rate as uncertain."}]},"cancellations":{"cancellationCount":1,"shortNoticeCount":1,"weekdays":[{"weekday":"tue","cancellationCount":1,"shortNoticeCount":1,"shortNoticeRate":1,"shortNoticeRateSupplied":true,"sampleSufficient":false,"uncertainty":"high"}],"sampleSufficient":false,"uncertainty":"high"},"capacity":[{"providerId":"P-1","name":"Dr Lee","bookedMinutes":150,"capacityMinutes":300,"capacityMinutesSupplied":true,"appointmentCount":5,"utilization":0.5,"utilizationSupplied":true,"overbooked":false}],"utilization":{"status":"calculated","bookedMinutes":150,"attendedMinutes":60,"capacityMinutes":300,"capacityMinutesSupplied":true,"scheduleUtilization":0.5,"scheduleUtilizationSupplied":true,"attendanceUtilization":0.2,"attendanceUtilizationSupplied":true,"providers":[{"providerId":"P-1","name":"Dr Lee","bookedMinutes":150,"capacityMinutes":300,"capacityMinutesSupplied":true,"appointmentCount":5,"utilization":0.5,"utilizationSupplied":true,"overbooked":false}],"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}],"findings":[]},"gaps":[{"providerId":"P-1","fromId":"A-1","toId":"A-3","fromEnd":"2026-11-02T10:30:00.000Z","toStart":"2026-11-02T11:00:00.000Z","gapMinutes":30,"thresholdMinutes":30},{"providerId":"P-1","fromId":"A-3","toId":"A-4","fromEnd":"2026-11-02T11:30:00.000Z","toStart":"2026-11-03T10:00:00.000Z","gapMinutes":1350,"thresholdMinutes":30},{"providerId":"P-1","fromId":"A-4","toId":"A-6","fromEnd":"2026-11-03T10:30:00.000Z","toStart":"2026-11-03T16:00:00.000Z","gapMinutes":330,"thresholdMinutes":30},{"providerId":"P-1","fromId":"A-6","toId":"A-2","fromEnd":"2026-11-03T16:30:00.000Z","toStart":"2026-11-09T10:00:00.000Z","gapMinutes":8250,"thresholdMinutes":30}],"reminders":{"withReminderCount":4,"withoutReminderCount":2,"timings":[{"label":"under_12h","appointmentCount":2,"decidedCount":2,"noShowCount":2,"noShowRate":1,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"label":"12h_to_24h","appointmentCount":0,"decidedCount":0,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":false,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"label":"24h_to_48h","appointmentCount":2,"decidedCount":2,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":true,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false},{"label":"over_48h","appointmentCount":0,"decidedCount":0,"noShowCount":0,"noShowRate":0,"noShowRateSupplied":false,"sampleSufficient":false,"uncertainty":"high","attendancePredicted":false}]},"recommendations":[{"code":"review_weekday","detail":"Observed no-show rate 0.6667 on mon across 3 decided appointments. Consider reviewing reminder timing for that day. This is not a prediction.","attendancePredicted":false},{"code":"review_hour","detail":"Observed no-show rate 0.6667 at hour 10 UTC across 3 decided appointments. This is an observed pattern, not a forecast.","attendancePredicted":false},{"code":"review_repeat_no_show","detail":"1 client id(s) have two or more recorded no-shows in the supplied history. Review booking policy using those counts only.","attendancePredicted":false},{"code":"review_short_notice_policy","detail":"Some cancellations occurred under 24 hours before the start time in the supplied timestamps.","attendancePredicted":false},{"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},{"code":"review_open_gaps","detail":"Found 4 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},{"code":"collect_reminder_outcomes","detail":"Reminder timestamps are present, but no timing window met the disclosed sample minimum for comparison.","attendancePredicted":false},{"code":"no_send","detail":"No reminder was sent by this endpoint. Timing analysis uses supplied reminder timestamps only.","attendancePredicted":false}],"reminderSent":false,"bookingModified":false,"protectedAttributesUsed":false,"attendancePredicted":false,"findings":[{"kind":"observation","code":"sample_small","subject":"tue","detail":"Sample size 2 is below the disclosed minimum of 3. Treat the rate as uncertain."},{"kind":"observation","code":"sample_small","subject":"tue","detail":"Sample size 1 is below the disclosed minimum of 3. Treat the rate as uncertain."},{"kind":"observation","code":"sample_small","subject":"cancellations","detail":"Sample size 1 is below the disclosed minimum of 3. Treat the rate as uncertain."},{"kind":"observation","code":"reminder_absent","subject":"A-5","detail":"No reminder timestamp was supplied for this appointment."},{"kind":"observation","code":"sample_small","subject":"under_12h","detail":"Sample size 2 is below the disclosed minimum of 3. Treat the rate as uncertain."},{"kind":"observation","code":"sample_small","subject":"24h_to_48h","detail":"Sample size 2 is below the disclosed minimum of 3. Treat the rate as uncertain."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}