# Caldasa API Docs ## API Docs - Availability [List availability slots](https://developer.caldasa.com/list-availability-slots-34424114e0.md): Returns the open booking slots for a single service variant on a given date. - Bookings [List bookings](https://developer.caldasa.com/list-bookings-34424115e0.md): Lists bookings across the tenant, newest first. Optional - Bookings [Create a booking](https://developer.caldasa.com/create-a-booking-34424116e0.md): Creates a new reservation through the same pipeline the portal uses — - Bookings [Get a booking](https://developer.caldasa.com/get-a-booking-34424117e0.md): Fetches a single booking by ID. - Bookings [Cancel a booking](https://developer.caldasa.com/cancel-a-booking-34424118e0.md): Cancels a booking and runs the standard portal-side cancellation flow: - Bookings [List signed forms](https://developer.caldasa.com/list-signed-forms-34424119e0.md): Lists the signed waivers and intake forms attached to a booking. Each - Bookings [Get a signed-form download URL](https://developer.caldasa.com/get-a-signed-form-download-url-34424120e0.md): Returns a time-limited signed URL for a single signed form's PDF. The - Customers [List customers](https://developer.caldasa.com/list-customers-34424121e0.md): Lists customers in the current tenant. Optional search - Customers [Create a customer](https://developer.caldasa.com/create-a-customer-34424122e0.md): - Customers [Get a customer](https://developer.caldasa.com/get-a-customer-34424123e0.md): Fetches a single customer by ID. - Customers [Update a customer](https://developer.caldasa.com/update-a-customer-34424124e0.md): Partially updates a customer. Fields omitted (or sent as `null`) are - Customers [List customer activities](https://developer.caldasa.com/list-customer-activities-34424125e0.md): Recent activity timeline for a customer (booking events, notes, messages — - Customers [List customer notes](https://developer.caldasa.com/list-customer-notes-34424126e0.md): Lists notes attached to a customer. Newest first. - Customers [Create a customer note](https://developer.caldasa.com/create-a-customer-note-34424127e0.md): Creates a note on a customer's profile. - Customers [Update a customer note](https://developer.caldasa.com/update-a-customer-note-34424128e0.md): - Customers [Delete a customer note](https://developer.caldasa.com/delete-a-customer-note-34424129e0.md): - Customers [Send a customer message](https://developer.caldasa.com/send-a-customer-message-34424130e0.md): Sends a message (SMS or email) to a customer. Goes through the same - Events [List events](https://developer.caldasa.com/list-events-34424131e0.md): Lists events in the tenant. Optional filters: locationId, - Events [Create an event](https://developer.caldasa.com/create-an-event-34424132e0.md): Creates a new event (group booking or ticketed event). - Events [Get an event](https://developer.caldasa.com/get-an-event-34424133e0.md): Fetches a single event with its full booking and attendee roster. - Events [Update an event](https://developer.caldasa.com/update-an-event-34424134e0.md): Partially updates an event. Omitted (or null) fields are unchanged. - Events [List ticket types](https://developer.caldasa.com/list-ticket-types-34424135e0.md): Lists ticket types defined for a ticketed event. - Events [Create a ticket type](https://developer.caldasa.com/create-a-ticket-type-34424136e0.md): Creates a ticket type for a ticketed event. - Events [Get ticket sales report](https://developer.caldasa.com/get-ticket-sales-report-34424137e0.md): Sales report for a ticketed event: revenue, tax, redemption and - Events [Publish an event](https://developer.caldasa.com/publish-an-event-34424138e0.md): Publishes a draft event. Once published, the event becomes `Open` - Events [Cancel an event](https://developer.caldasa.com/cancel-an-event-34424139e0.md): Cancels an event. Releases or refunds bookings depending on the event's - Events [Update a ticket type](https://developer.caldasa.com/update-a-ticket-type-34424140e0.md): Partially updates a ticket type. - Events [Delete a ticket type](https://developer.caldasa.com/delete-a-ticket-type-34424141e0.md): Deletes a ticket type. Fails if any tickets have already been issued for it. - Events [List ticket orders](https://developer.caldasa.com/list-ticket-orders-34424142e0.md): Lists ticket orders for an event. Each row includes the lead buyer info, - Events [Cancel a ticket order](https://developer.caldasa.com/cancel-a-ticket-order-34424143e0.md): Cancels a ticket order. Refunds the captured payment, flips every issued - Events [Resend ticket QR codes](https://developer.caldasa.com/resend-ticket-qr-codes-34424144e0.md): Resends ticket QR codes to the buyer. Rotates the underlying - Forms [List form templates](https://developer.caldasa.com/list-form-templates-34424145e0.md): Lists form templates. Optional status filter (Draft / Published / Archived). - Forms [Get a form template](https://developer.caldasa.com/get-a-form-template-34424146e0.md): Fetches a single form template, including its field overlay positions. - Locations [List locations](https://developer.caldasa.com/list-locations-34424147e0.md): List business locations in the tenant. Page-based pagination (1-indexed) via `page` and `pageSize`. - Locations [Create a location](https://developer.caldasa.com/create-a-location-34424148e0.md): - Locations [Get a location](https://developer.caldasa.com/get-a-location-34424149e0.md): Fetches a single business location by ID. - Locations [Update a location](https://developer.caldasa.com/update-a-location-34424150e0.md): Updates location details (display fields, time zone, contact info). Address - Locations [Delete a location](https://developer.caldasa.com/delete-a-location-34424151e0.md): Soft-deletes a business location. - Locations [List business hours](https://developer.caldasa.com/list-business-hours-34424152e0.md): Weekly business hours for a location (one row per open window; - Locations [Replace business hours](https://developer.caldasa.com/replace-business-hours-34424153e0.md): Replaces the weekly business hours for a location with the supplied set - Locations [Update location address](https://developer.caldasa.com/update-location-address-34424154e0.md): Updates the location's mailing address. Triggers re-geocoding. - Locations [List location staff](https://developer.caldasa.com/list-location-staff-34424155e0.md): Lists staff members assigned to this location. - Locations [Assign staff to a location](https://developer.caldasa.com/assign-staff-to-a-location-34424156e0.md): Assigns an existing staff member to this location. - Locations [Unassign staff from a location](https://developer.caldasa.com/unassign-staff-from-a-location-34424157e0.md): Unassigns a staff member from this location. - Orders [List orders](https://developer.caldasa.com/list-orders-34424158e0.md): Lists orders matching the supplied filter. Cursor pagination, default page size 50. - Orders [Get an order](https://developer.caldasa.com/get-an-order-34424159e0.md): Fetches a single order by ID, including line items and tickets. - Reservables [List reservables](https://developer.caldasa.com/list-reservables-34424160e0.md): Lists reservables in the tenant. Optional locationId - Reservables [Create a reservable](https://developer.caldasa.com/create-a-reservable-34424161e0.md): Creates a reservable (bookable service). - Reservables [Get a reservable](https://developer.caldasa.com/get-a-reservable-34424162e0.md): Fetches a single reservable by ID. - Reservables [Update a reservable](https://developer.caldasa.com/update-a-reservable-34424163e0.md): Updates a reservable. Full replacement — supply every field. To change - Reservables [Delete a reservable](https://developer.caldasa.com/delete-a-reservable-34424164e0.md): Soft-deletes a reservable. - Reservables [List reservable variants](https://developer.caldasa.com/list-reservable-variants-34424165e0.md): Lists all variants attached to a reservable (a reservable has at least - Reservables [List reservable staff](https://developer.caldasa.com/list-reservable-staff-34424166e0.md): Lists the staff members assigned to perform this service. - Resources [List resources](https://developer.caldasa.com/list-resources-34424167e0.md): Lists resources in the tenant. Optional locationId - Resources [Create a resource](https://developer.caldasa.com/create-a-resource-34424168e0.md): Creates a physical resource (room, boat, treatment table, …). - Resources [Get a resource](https://developer.caldasa.com/get-a-resource-34424169e0.md): Fetches a single resource by ID. - Resources [Update a resource](https://developer.caldasa.com/update-a-resource-34424170e0.md): Updates a resource. Full replacement. - Resources [Delete a resource](https://developer.caldasa.com/delete-a-resource-34424171e0.md): Soft-deletes a resource. - Resources [List resource types](https://developer.caldasa.com/list-resource-types-34424172e0.md): Lists resource types in the tenant. Optional locationId filter. - Resources [Create a resource type](https://developer.caldasa.com/create-a-resource-type-34424173e0.md): Creates a resource type (a bucket like "Boats" or "Treatment Rooms"). - Resources [Get a resource type](https://developer.caldasa.com/get-a-resource-type-34424174e0.md): Fetches a single resource type by ID. - Resources [Update a resource type](https://developer.caldasa.com/update-a-resource-type-34424175e0.md): Updates a resource type. Full replacement. - Resources [Delete a resource type](https://developer.caldasa.com/delete-a-resource-type-34424176e0.md): Soft-deletes a resource type. Cascades to its resources. - Reviews [List reviews](https://developer.caldasa.com/list-reviews-34424177e0.md): Lists reviews for a business location. locationId is - Reviews [Moderate a review](https://developer.caldasa.com/moderate-a-review-34424178e0.md): Approve, hide, or reply to a review. Approving publishes the review; - Staff [List staff members](https://developer.caldasa.com/list-staff-members-34424179e0.md): Lists staff members in the tenant. Page-based pagination (1-indexed). - Staff [Create a staff member](https://developer.caldasa.com/create-a-staff-member-34424180e0.md): - Staff [Get a staff member](https://developer.caldasa.com/get-a-staff-member-34424181e0.md): Fetches a single staff member by ID. - Staff [Update a staff member](https://developer.caldasa.com/update-a-staff-member-34424182e0.md): Updates a staff member. Full replacement. - Staff [Delete a staff member](https://developer.caldasa.com/delete-a-staff-member-34424183e0.md): Soft-deletes a staff member. - Staff [List staff shifts](https://developer.caldasa.com/list-staff-shifts-34424184e0.md): Lists working shifts for a staff member. Optional - Staff [Create a staff shift](https://developer.caldasa.com/create-a-staff-shift-34424185e0.md): Schedules a working shift for a staff member at a location. - Staff [List staff blocks](https://developer.caldasa.com/list-staff-blocks-34424186e0.md): Lists time-off / blackout blocks for a staff member. Optional - Staff [Create a staff block](https://developer.caldasa.com/create-a-staff-block-34424187e0.md): Adds a time-off / blackout block for a staff member at a location. - Staff [Delete a staff shift](https://developer.caldasa.com/delete-a-staff-shift-34424188e0.md): - Staff [Delete a staff block](https://developer.caldasa.com/delete-a-staff-block-34424189e0.md): - Tenant [Get the current tenant](https://developer.caldasa.com/get-the-current-tenant-34424190e0.md): Returns the tenant the calling API key belongs to. - Tickets [Redeem a ticket](https://developer.caldasa.com/redeem-a-ticket-34424191e0.md): Redeems a ticket token for the given event. First scan wins — re-scans - Webhooks [List event types](https://developer.caldasa.com/list-event-types-34424192e0.md): Lists all event types this tenant can subscribe to. Each entry includes - Webhooks [Get an event-type sample](https://developer.caldasa.com/get-an-event-type-sample-34424193e0.md): Returns the full event envelope (`id` / `type` / - Webhooks [List webhooks](https://developer.caldasa.com/list-webhooks-34424194e0.md): Lists webhook subscriptions for the tenant. - Webhooks [Create a webhook](https://developer.caldasa.com/create-a-webhook-34424195e0.md): Creates a webhook subscription. The response includes the signing - Webhooks [Update a webhook](https://developer.caldasa.com/update-a-webhook-34424196e0.md): Partially updates a subscription. Omitted (or null) fields are - Webhooks [Delete a webhook](https://developer.caldasa.com/delete-a-webhook-34424197e0.md): Deletes a subscription. Cascades to its delivery history. - Webhooks [Rotate webhook secret](https://developer.caldasa.com/rotate-webhook-secret-34424198e0.md): Rotates the signing secret. The old secret is invalidated immediately; - Webhooks [Send a test event](https://developer.caldasa.com/send-a-test-event-34424199e0.md): Sends a synthetic test event matching one of the subscribed event - Webhooks [List webhook deliveries](https://developer.caldasa.com/list-webhook-deliveries-34424200e0.md): Lists recent delivery attempts (up to 100), newest first. Useful for ## Schemas - [CancelPublicTicketOrderRequest](https://developer.caldasa.com/cancelpublicticketorderrequest-14618141d0.md): - [CreatePublicBookableEventRequest](https://developer.caldasa.com/createpublicbookableeventrequest-14618142d0.md): - [CreatePublicBookingItemRequest](https://developer.caldasa.com/createpublicbookingitemrequest-14618143d0.md): - [CreatePublicBookingRequest](https://developer.caldasa.com/createpublicbookingrequest-14618144d0.md): - [CreatePublicBusinessLocationRequest](https://developer.caldasa.com/createpublicbusinesslocationrequest-14618145d0.md): - [CreatePublicCustomerNoteRequest](https://developer.caldasa.com/createpubliccustomernoterequest-14618146d0.md): - [CreatePublicCustomerRequest](https://developer.caldasa.com/createpubliccustomerrequest-14618147d0.md): - [CreatePublicReservableRequest](https://developer.caldasa.com/createpublicreservablerequest-14618148d0.md): - [CreatePublicResourceRequest](https://developer.caldasa.com/createpublicresourcerequest-14618149d0.md): - [CreatePublicResourceTypeRequest](https://developer.caldasa.com/createpublicresourcetyperequest-14618150d0.md): - [CreatePublicStaffBlockRequest](https://developer.caldasa.com/createpublicstaffblockrequest-14618151d0.md): - [CreatePublicStaffMemberRequest](https://developer.caldasa.com/createpublicstaffmemberrequest-14618152d0.md): - [CreatePublicStaffShiftRequest](https://developer.caldasa.com/createpublicstaffshiftrequest-14618153d0.md): - [CreatePublicTicketTypeRequest](https://developer.caldasa.com/createpublictickettyperequest-14618154d0.md): - [CreatePublicWebhookSubscriptionRequest](https://developer.caldasa.com/createpublicwebhooksubscriptionrequest-14618155d0.md): - [ModeratePublicReviewRequest](https://developer.caldasa.com/moderatepublicreviewrequest-14618156d0.md): - [ProblemDetails](https://developer.caldasa.com/problemdetails-14618157d0.md): - [PublicAvailabilityResponse](https://developer.caldasa.com/publicavailabilityresponse-14618158d0.md): - [PublicAvailabilitySlotDto](https://developer.caldasa.com/publicavailabilityslotdto-14618159d0.md): - [PublicBookableEventAttendeeDto](https://developer.caldasa.com/publicbookableeventattendeedto-14618160d0.md): - [PublicBookableEventBookingSummaryDto](https://developer.caldasa.com/publicbookableeventbookingsummarydto-14618161d0.md): - [PublicBookableEventDetailDto](https://developer.caldasa.com/publicbookableeventdetaildto-14618162d0.md): - [PublicBookableEventDto](https://developer.caldasa.com/publicbookableeventdto-14618163d0.md): - [PublicBookableEventListResponse](https://developer.caldasa.com/publicbookableeventlistresponse-14618164d0.md): - [PublicBookingDto](https://developer.caldasa.com/publicbookingdto-14618165d0.md): - [PublicBookingItemDto](https://developer.caldasa.com/publicbookingitemdto-14618166d0.md): - [PublicBookingListResponse](https://developer.caldasa.com/publicbookinglistresponse-14618167d0.md): - [PublicBookingResourceSelection](https://developer.caldasa.com/publicbookingresourceselection-14618168d0.md): - [PublicBusinessHourDto](https://developer.caldasa.com/publicbusinesshourdto-14618169d0.md): - [PublicBusinessHourListResponse](https://developer.caldasa.com/publicbusinesshourlistresponse-14618170d0.md): - [PublicBusinessLocationDto](https://developer.caldasa.com/publicbusinesslocationdto-14618171d0.md): - [PublicBusinessLocationListResponse](https://developer.caldasa.com/publicbusinesslocationlistresponse-14618172d0.md): - [PublicBusinessLocationStaffDto](https://developer.caldasa.com/publicbusinesslocationstaffdto-14618173d0.md): - [PublicBusinessLocationStaffListResponse](https://developer.caldasa.com/publicbusinesslocationstafflistresponse-14618174d0.md): - [PublicCustomerActivityDto](https://developer.caldasa.com/publiccustomeractivitydto-14618175d0.md): - [PublicCustomerActivityListResponse](https://developer.caldasa.com/publiccustomeractivitylistresponse-14618176d0.md): - [PublicCustomerDto](https://developer.caldasa.com/publiccustomerdto-14618177d0.md): - [PublicCustomerListResponse](https://developer.caldasa.com/publiccustomerlistresponse-14618178d0.md): - [PublicCustomerNoteDto](https://developer.caldasa.com/publiccustomernotedto-14618179d0.md): - [PublicCustomerNoteListResponse](https://developer.caldasa.com/publiccustomernotelistresponse-14618180d0.md): - [PublicFormTemplateDto](https://developer.caldasa.com/publicformtemplatedto-14618181d0.md): - [PublicFormTemplateFieldDto](https://developer.caldasa.com/publicformtemplatefielddto-14618182d0.md): - [PublicFormTemplateListResponse](https://developer.caldasa.com/publicformtemplatelistresponse-14618183d0.md): - [PublicOrderDetailDto](https://developer.caldasa.com/publicorderdetaildto-14618184d0.md): - [PublicOrderDto](https://developer.caldasa.com/publicorderdto-14618185d0.md): - [PublicOrderLineItemDto](https://developer.caldasa.com/publicorderlineitemdto-14618186d0.md): - [PublicOrderListResponse](https://developer.caldasa.com/publicorderlistresponse-14618187d0.md): - [PublicOrderTicketDto](https://developer.caldasa.com/publicorderticketdto-14618188d0.md): - [PublicReservableDto](https://developer.caldasa.com/publicreservabledto-14618189d0.md): - [PublicReservableListResponse](https://developer.caldasa.com/publicreservablelistresponse-14618190d0.md): - [PublicReservableResourceSummary](https://developer.caldasa.com/publicreservableresourcesummary-14618191d0.md): - [PublicReservableStaffDto](https://developer.caldasa.com/publicreservablestaffdto-14618192d0.md): - [PublicReservableStaffListResponse](https://developer.caldasa.com/publicreservablestafflistresponse-14618193d0.md): - [PublicReservableVariantDto](https://developer.caldasa.com/publicreservablevariantdto-14618194d0.md): - [PublicReservableVariantListResponse](https://developer.caldasa.com/publicreservablevariantlistresponse-14618195d0.md): - [PublicResourceDto](https://developer.caldasa.com/publicresourcedto-14618196d0.md): - [PublicResourceListResponse](https://developer.caldasa.com/publicresourcelistresponse-14618197d0.md): - [PublicResourceTypeDto](https://developer.caldasa.com/publicresourcetypedto-14618198d0.md): - [PublicResourceTypeListResponse](https://developer.caldasa.com/publicresourcetypelistresponse-14618199d0.md): - [PublicReviewDto](https://developer.caldasa.com/publicreviewdto-14618200d0.md): - [PublicReviewListResponse](https://developer.caldasa.com/publicreviewlistresponse-14618201d0.md): - [PublicSignedFormDownloadDto](https://developer.caldasa.com/publicsignedformdownloaddto-14618202d0.md): - [PublicSignedFormDto](https://developer.caldasa.com/publicsignedformdto-14618203d0.md): - [PublicSignedFormListResponse](https://developer.caldasa.com/publicsignedformlistresponse-14618204d0.md): - [PublicStaffBlockDto](https://developer.caldasa.com/publicstaffblockdto-14618205d0.md): - [PublicStaffBlockListResponse](https://developer.caldasa.com/publicstaffblocklistresponse-14618206d0.md): - [PublicStaffMemberDto](https://developer.caldasa.com/publicstaffmemberdto-14618207d0.md): - [PublicStaffMemberListResponse](https://developer.caldasa.com/publicstaffmemberlistresponse-14618208d0.md): - [PublicStaffShiftDto](https://developer.caldasa.com/publicstaffshiftdto-14618209d0.md): - [PublicStaffShiftListResponse](https://developer.caldasa.com/publicstaffshiftlistresponse-14618210d0.md): - [PublicTenantDto](https://developer.caldasa.com/publictenantdto-14618211d0.md): - [PublicTicketOrderDto](https://developer.caldasa.com/publicticketorderdto-14618212d0.md): - [PublicTicketOrderTicketDto](https://developer.caldasa.com/publicticketorderticketdto-14618213d0.md): - [PublicTicketOrdersResponse](https://developer.caldasa.com/publicticketordersresponse-14618214d0.md): - [PublicTicketRedemptionResultDto](https://developer.caldasa.com/publicticketredemptionresultdto-14618215d0.md): - [PublicTicketSalesReportDto](https://developer.caldasa.com/publicticketsalesreportdto-14618216d0.md): - [PublicTicketSalesReportTier](https://developer.caldasa.com/publicticketsalesreporttier-14618217d0.md): - [PublicTicketTypeDto](https://developer.caldasa.com/publictickettypedto-14618218d0.md): - [PublicTicketTypeListResponse](https://developer.caldasa.com/publictickettypelistresponse-14618219d0.md): - [PublicWebhookDeliveryDto](https://developer.caldasa.com/publicwebhookdeliverydto-14618220d0.md): - [PublicWebhookDeliveryListResponse](https://developer.caldasa.com/publicwebhookdeliverylistresponse-14618221d0.md): - [PublicWebhookEventDescriptorDto](https://developer.caldasa.com/publicwebhookeventdescriptordto-14618222d0.md): - [PublicWebhookEventTypeListResponse](https://developer.caldasa.com/publicwebhookeventtypelistresponse-14618223d0.md): - [PublicWebhookSubscriptionDto](https://developer.caldasa.com/publicwebhooksubscriptiondto-14618224d0.md): - [PublicWebhookSubscriptionListResponse](https://developer.caldasa.com/publicwebhooksubscriptionlistresponse-14618225d0.md): - [PublicWebhookSubscriptionWithSecretDto](https://developer.caldasa.com/publicwebhooksubscriptionwithsecretdto-14618226d0.md): - [RedeemPublicTicketRequest](https://developer.caldasa.com/redeempublicticketrequest-14618227d0.md): - [SendPublicCustomerMessageRequest](https://developer.caldasa.com/sendpubliccustomermessagerequest-14618228d0.md): - [SendPublicCustomerMessageResult](https://developer.caldasa.com/sendpubliccustomermessageresult-14618229d0.md): - [UpdatePublicBookableEventRequest](https://developer.caldasa.com/updatepublicbookableeventrequest-14618230d0.md): - [UpdatePublicBusinessHourEntry](https://developer.caldasa.com/updatepublicbusinesshourentry-14618231d0.md): - [UpdatePublicBusinessHoursRequest](https://developer.caldasa.com/updatepublicbusinesshoursrequest-14618232d0.md): - [UpdatePublicBusinessLocationAddressRequest](https://developer.caldasa.com/updatepublicbusinesslocationaddressrequest-14618233d0.md): - [UpdatePublicBusinessLocationDetailsRequest](https://developer.caldasa.com/updatepublicbusinesslocationdetailsrequest-14618234d0.md): - [UpdatePublicCustomerNoteRequest](https://developer.caldasa.com/updatepubliccustomernoterequest-14618235d0.md): - [UpdatePublicCustomerRequest](https://developer.caldasa.com/updatepubliccustomerrequest-14618236d0.md): - [UpdatePublicReservableRequest](https://developer.caldasa.com/updatepublicreservablerequest-14618237d0.md): - [UpdatePublicResourceRequest](https://developer.caldasa.com/updatepublicresourcerequest-14618238d0.md): - [UpdatePublicResourceTypeRequest](https://developer.caldasa.com/updatepublicresourcetyperequest-14618239d0.md): - [UpdatePublicStaffMemberRequest](https://developer.caldasa.com/updatepublicstaffmemberrequest-14618240d0.md): - [UpdatePublicTicketTypeRequest](https://developer.caldasa.com/updatepublictickettyperequest-14618241d0.md): - [UpdatePublicWebhookSubscriptionRequest](https://developer.caldasa.com/updatepublicwebhooksubscriptionrequest-14618242d0.md): - [ValidationProblemDetails](https://developer.caldasa.com/validationproblemdetails-14618243d0.md):