{"id":"appointment-fit","title":"Does this appointment fit: opening hours in the venue's zone, closed days, existing bookings with buffers, minimum notice","description":"Checks one proposed appointment (instant + duration) against a venue's local opening hours per weekday, closed dates or a named holiday calendar, up to 500 existing bookings with a buffer on each side, and a minimum notice measured from a caller-supplied asOf; every violated rule is returned as a witness with the conflicting booking or hour block. Local hours are resolved in the venue's IANA zone so DST days are correct. It does not search for free slots (use slot-intersect), know staff or resource capacity, or read the clock.","roi":"The booking that lands at 17:30 local after a DST change, on a bank holiday or 10 minutes after another one is caught before it is confirmed.","audience":"business","package":"calendar-deadline-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/appointment-fit","path":"/api/v1/appointment-fit","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["start","durationMinutes","timeZone","hours"],"properties":{"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36},"durationMinutes":{"type":"integer","minimum":1,"maximum":1440},"timeZone":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_+-]*(/[A-Za-z0-9_+-]+){0,2}$","maxLength":64,"description":"Venue zone in which hours apply."},"hours":{"type":"array","minItems":1,"maxItems":28,"items":{"type":"object","required":["days","open","close"],"properties":{"days":{"type":"array","minItems":1,"maxItems":7,"items":{"type":"integer","minimum":0,"maximum":6},"description":"0=Sunday..6=Saturday."},"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","maxLength":5},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","maxLength":5,"description":"Exclusive end, local; must be after open (no overnight blocks)."}}}},"calendar":{"type":"string","enum":["us-federal","us-federal-reserve","nyse","us-equities-settlement","uk-england-and-wales","uk-scotland","uk-northern-ireland","weekends-only","caller"],"description":"Optional named holiday calendar for closed days (unsupported outside its range). Without it only holidays/weekend you list apply; hours decide the weekdays."},"holidays":{"type":"array","maxItems":400,"items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","maxLength":10},"description":"Extra non-business dates YYYY-MM-DD (company closures, a calendar we do not carry)."},"weekend":{"type":"array","maxItems":6,"items":{"type":"integer","minimum":0,"maximum":6},"description":"Ignored for hours; with a named calendar only its holidays are used."},"bookings":{"type":"array","maxItems":500,"items":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36},"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36}}}},"bufferMinutes":{"type":"integer","minimum":0,"maximum":1440,"description":"Required gap on each side of the appointment."},"minNoticeMinutes":{"type":"integer","minimum":0,"maximum":525600,"description":"Needs asOf."},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36,"description":"Reference instant for minimum notice."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"startLocal":{"type":"string"},"endLocal":{"type":"string"},"withinHours":{"type":"boolean"},"closedDay":{"type":"boolean"},"conflicts":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"startUtc":{"type":"string"},"endUtc":{"type":"string"}}}},"noticeMinutes":{"type":"integer"},"reason":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"startLocal":{"type":"string"},"endLocal":{"type":"string"},"withinHours":{"type":"boolean"},"closedDay":{"type":"boolean"},"conflicts":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"startUtc":{"type":"string"},"endUtc":{"type":"string"}}}},"noticeMinutes":{"type":"integer"},"reason":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"start":"2026-11-09T15:00:00Z","durationMinutes":45,"timeZone":"America/New_York","hours":[{"days":[1,2,3,4,5],"open":"09:00","close":"17:00"}],"bookings":[{"start":"2026-11-09T14:00:00Z","end":"2026-11-09T14:50:00Z"}],"bufferMinutes":15},"openapiOperation":{"operationId":"appointment_fit","summary":"Does this appointment fit: opening hours in the venue's zone, closed days, existing bookings with buffers, minimum notice","description":"Checks one proposed appointment (instant + duration) against a venue's local opening hours per weekday, closed dates or a named holiday calendar, up to 500 existing bookings with a buffer on each side, and a minimum notice measured from a caller-supplied asOf; every violated rule is returned as a witness with the conflicting booking or hour block. Local hours are resolved in the venue's IANA zone so DST days are correct. It does not search for free slots (use slot-intersect), know staff or resource capacity, or read the clock.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/appointment-fit","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["start","durationMinutes","timeZone","hours"],"properties":{"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36},"durationMinutes":{"type":"integer","minimum":1,"maximum":1440},"timeZone":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_+-]*(/[A-Za-z0-9_+-]+){0,2}$","maxLength":64,"description":"Venue zone in which hours apply."},"hours":{"type":"array","minItems":1,"maxItems":28,"items":{"type":"object","required":["days","open","close"],"properties":{"days":{"type":"array","minItems":1,"maxItems":7,"items":{"type":"integer","minimum":0,"maximum":6},"description":"0=Sunday..6=Saturday."},"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","maxLength":5},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","maxLength":5,"description":"Exclusive end, local; must be after open (no overnight blocks)."}}}},"calendar":{"type":"string","enum":["us-federal","us-federal-reserve","nyse","us-equities-settlement","uk-england-and-wales","uk-scotland","uk-northern-ireland","weekends-only","caller"],"description":"Optional named holiday calendar for closed days (unsupported outside its range). Without it only holidays/weekend you list apply; hours decide the weekdays."},"holidays":{"type":"array","maxItems":400,"items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","maxLength":10},"description":"Extra non-business dates YYYY-MM-DD (company closures, a calendar we do not carry)."},"weekend":{"type":"array","maxItems":6,"items":{"type":"integer","minimum":0,"maximum":6},"description":"Ignored for hours; with a named calendar only its holidays are used."},"bookings":{"type":"array","maxItems":500,"items":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36},"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36}}}},"bufferMinutes":{"type":"integer","minimum":0,"maximum":1440,"description":"Required gap on each side of the appointment."},"minNoticeMinutes":{"type":"integer","minimum":0,"maximum":525600,"description":"Needs asOf."},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|z|[+-]\\d{2}:?\\d{2})$","maxLength":36,"description":"Reference instant for minimum notice."}}},"example":{"start":"2026-11-09T15:00:00Z","durationMinutes":45,"timeZone":"America/New_York","hours":[{"days":[1,2,3,4,5],"open":"09:00","close":"17:00"}],"bookings":[{"start":"2026-11-09T14:00:00Z","end":"2026-11-09T14:50:00Z"}],"bufferMinutes":15}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"startLocal":{"type":"string"},"endLocal":{"type":"string"},"withinHours":{"type":"boolean"},"closedDay":{"type":"boolean"},"conflicts":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"startUtc":{"type":"string"},"endUtc":{"type":"string"}}}},"noticeMinutes":{"type":"integer"},"reason":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/appointment-fit/","docsJson":"https://agents.writerslogic.com/docs/appointment-fit.json","sample":"https://agents.writerslogic.com/api/v1/samples/appointment-fit","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}