{"openapi":"3.1.0","info":{"title":"EZBookPlus Third-Party Booking API","version":"2.0.0","description":"Power a fully branded scheduling experience on a business website while EZBookPlus remains the private scheduling backend."},"servers":[{"url":"https://ezbookplus.com/api/v1"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-EZBookPlus-Key"}}},"security":[{"ApiKey":[]}],"paths":{"/business":{"get":{"summary":"Get the connected public business profile"}},"/services":{"get":{"summary":"List active services"}},"/providers":{"get":{"summary":"List active professionals"}},"/availability":{"get":{"summary":"List available appointment times","parameters":[{"name":"service_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"provider_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","required":true,"schema":{"type":"string"}}]}},"/booking-links":{"post":{"summary":"Create a secure booking handoff link for an available time"}},"/bookings":{"post":{"summary":"Create an appointment directly from the connected website","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Rechecks the slot and creates an unpaid booking, then returns the business-enabled payment choices without sending the customer to an EZBookPlus page."}},"/payment-checkouts":{"post":{"summary":"Start Stripe Checkout for an API-created appointment"}},"/payment-receipts":{"post":{"summary":"Submit Cash App, PayPal, or Venmo evidence for advisory AI screening and business approval"}},"/payment-status":{"post":{"summary":"Read payment status for an API-created appointment capability"}},"/pay-in-person":{"post":{"summary":"Choose pay in person for an API-created appointment"}},"/classes":{"get":{"summary":"List active class and group activities"}},"/class-sessions":{"get":{"summary":"List upcoming class sessions and remaining seats","parameters":[{"name":"activity_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"}}]}},"/memberships":{"get":{"summary":"List active monthly membership plans"}},"/add-ons":{"get":{"summary":"List active one-time add-ons"}},"/class-booking-links":{"post":{"summary":"Create a secure handoff link for an available class session"}},"/membership-links":{"post":{"summary":"Create a secure handoff link for an active membership plan"}},"/add-on-links":{"post":{"summary":"Create a secure handoff link for an active add-on"}},"/openapi.json":{"get":{"summary":"Download this OpenAPI description","security":[]}}}}