# Boseat Documentation

> Public API documentation for the Boseat booking platform.

## Docs

- [Confirm or update a booking](https://docs.boseat.com/api-reference/bookings/confirm-or-update-a-booking.md): Confirms a pending booking or updates an existing booking with customer information. This endpoint finalizes the booking by setting its status to CONFIRMED or CANCEL. If payment is enabled and required, a Stripe checkout session is created and the Location header contains the checkout URL. Customer…
- [Create a booking](https://docs.boseat.com/api-reference/bookings/create-a-booking.md): Creates a new booking reservation for a space and product. The booking is initially created in PENDING status. Customer contact information (email, phone) is optional at creation but required when confirming the booking. The system verifies slot availability before creating the booking.
- [Delete a booking](https://docs.boseat.com/api-reference/bookings/delete-a-booking.md): Permanently deletes a booking by its ID. Deletion is only allowed for bookings in certain statuses (typically PENDING or CANCEL). Confirmed bookings may require cancellation first. This action is irreversible.
- [Get available booking slots](https://docs.boseat.com/api-reference/bookings/get-available-booking-slots.md): Retrieves all available time slots for booking a specific space with a given product. This endpoint is typically used to display available booking times in a calendar or booking interface. Slots are calculated based on space availability, opening hours, and existing bookings.
- [Get booking details](https://docs.boseat.com/api-reference/bookings/get-booking-details.md): Retrieves comprehensive details of a specific booking including customer information, space details, product information, time slot, and status.
- [List all bookings](https://docs.boseat.com/api-reference/bookings/list-all-bookings.md): Retrieves a paginated list of all bookings for the current organization. Supports filtering by space IDs and customer ID. Results are paginated and can be sorted by various fields.
- [Create a new customer](https://docs.boseat.com/api-reference/customers/create-a-new-customer.md): Creates a new customer or retrieves an existing customer if one with the same email already exists (find-or-create pattern). This prevents duplicate customer records and is useful for booking flows where customers may already be registered.
- [Delete a customer by ID](https://docs.boseat.com/api-reference/customers/delete-a-customer-by-id.md): Permanently deletes a customer from the organization records. This action is irreversible. Customers with associated bookings or invoices may not be deletable.
- [Get a customer by ID](https://docs.boseat.com/api-reference/customers/get-a-customer-by-id.md): Retrieves detailed information about a specific customer including contact details, type (individual or company), billing address, and company information if applicable.
- [Get all customers](https://docs.boseat.com/api-reference/customers/get-all-customers.md): Retrieves a paginated list of all customers for the current organization. Results include customer contact information, type (individual/company), and billing details.
- [Update an existing customer](https://docs.boseat.com/api-reference/customers/update-an-existing-customer.md): Updates customer information including contact details, billing address, and company information. All fields are optional - only provided fields will be updated.
- [Get Google Calendar integration](https://docs.boseat.com/api-reference/integrations-google-calendar/get-google-calendar-integration.md): Returns the current Google Calendar integration for the tenant account if it exists.
- [List calendar resources](https://docs.boseat.com/api-reference/integrations-google-calendar/list-calendar-resources.md): Retrieve all calendar resources available from the Google account integration.
- [Update Google Calendar integration](https://docs.boseat.com/api-reference/integrations-google-calendar/update-google-calendar-integration.md): Update the configuration of the Google Calendar integration and optionally refresh available calendars.
- [Disconnect an integration](https://docs.boseat.com/api-reference/integrations/disconnect-an-integration.md): Remove an integration by its ID for the current organization.
- [Get all integrations](https://docs.boseat.com/api-reference/integrations/get-all-integrations.md): Retrieve all active integrations filtered by kind and/or type if provided.
- [Handle Nango webhook events](https://docs.boseat.com/api-reference/integrations/handle-nango-webhook-events.md): Accept and verify webhook events from Nango for integration syncing.
- [OAuth callback proxy](https://docs.boseat.com/api-reference/integrations/oauth-callback-proxy.md): Redirect OAuth callback request to Nango backend.
- [Create a new invoice](https://docs.boseat.com/api-reference/invoices/create-a-new-invoice.md): Creates a new invoice for a customer. Invoices are initially created in DRAFT status and can be updated until sent. The invoice includes line items, pricing, VAT calculations, and payment information.
- [Delete an invoice by ID](https://docs.boseat.com/api-reference/invoices/delete-an-invoice-by-id.md): Permanently deletes an invoice. Only invoices in DRAFT status can typically be deleted. Paid or sent invoices may be restricted from deletion for accounting purposes.
- [Get all invoices for a tenant](https://docs.boseat.com/api-reference/invoices/get-all-invoices-for-a-tenant.md): Retrieves a paginated list of all invoices for the organization. Results include invoice status, amounts, customer information, and payment details.
- [Get one invoice by ID](https://docs.boseat.com/api-reference/invoices/get-one-invoice-by-id.md): Retrieves detailed information about a specific invoice including all line items, pricing breakdown, VAT calculations, payment status, and PDF information if available.
- [Update an invoice (only if draft)](https://docs.boseat.com/api-reference/invoices/update-an-invoice-only-if-draft.md): Updates invoice details including line items, customer information, and amounts. Only invoices in DRAFT status can be updated. Once an invoice is sent, it becomes read-only.
- [Delete a media file by key](https://docs.boseat.com/api-reference/products-medias/delete-a-media-file-by-key.md)
- [Upload a media file](https://docs.boseat.com/api-reference/products-medias/upload-a-media-file.md)
- [Create a new product](https://docs.boseat.com/api-reference/products/create-a-new-product.md): Creates a new product (service or item) that can be associated with spaces for booking or sold as additional services. Products define pricing, duration rules, and availability.
- [Delete a product by ID](https://docs.boseat.com/api-reference/products/delete-a-product-by-id.md): Permanently deletes a product. This action is irreversible. Products that are associated with active bookings or invoices may not be deletable.
- [Get a single product by ID](https://docs.boseat.com/api-reference/products/get-a-single-product-by-id.md): Retrieves detailed information about a specific product including pricing, metadata, associated spaces, and configuration.
- [Get all products (paginated)](https://docs.boseat.com/api-reference/products/get-all-products-paginated.md): Retrieves a paginated list of products for the organization. Supports filtering by category (booking/additional), by specific product IDs, or by space ID. Always returns paginated results for consistent API behavior.
- [Update an existing product](https://docs.boseat.com/api-reference/products/update-an-existing-product.md): Updates product details including name, description, metadata, and space associations. Note: price cannot be updated via this endpoint. All other fields are optional - only provided fields will be updated. The Location header indicates where to find the updated resource.
- [Create a new quote](https://docs.boseat.com/api-reference/quotes/create-a-new-quote.md): Creates a new quote (price estimate) for a customer. Quotes are initially created in DRAFT status and can be updated until sent. Quotes can later be converted to invoices.
- [Get all quotes](https://docs.boseat.com/api-reference/quotes/get-all-quotes.md): Retrieves a paginated list of all quotes for the organization. Results include quote status, customer information, items, and pricing details.
- [Get quote by ID](https://docs.boseat.com/api-reference/quotes/get-quote-by-id.md): Retrieves detailed information about a specific quote including all items, pricing breakdown, VAT calculations, status, and customer information.
- [Update a quote partially](https://docs.boseat.com/api-reference/quotes/update-a-quote-partially.md): Updates quote details including items, pricing, status, and customer information. All fields are optional - only provided fields will be updated. Only quotes in DRAFT status can typically be updated.
- [Delete a media file by key](https://docs.boseat.com/api-reference/venues-medias/delete-a-media-file-by-key.md)
- [Upload a media file](https://docs.boseat.com/api-reference/venues-medias/upload-a-media-file.md)
- [Create a new space for a venue](https://docs.boseat.com/api-reference/venues-spaces/create-a-new-space-for-a-venue.md): Creates a new space (bookable room or area) within a venue. The space must be associated with a venue and can optionally be linked to products for booking.
- [Delete a specific space](https://docs.boseat.com/api-reference/venues-spaces/delete-a-specific-space.md): Permanently deletes a space and all associated data. This action is irreversible and will remove all bookings, products, and metadata associated with the space.
- [Get a specific space by slug](https://docs.boseat.com/api-reference/venues-spaces/get-a-specific-space-by-slug.md): Retrieves detailed information about a space using its URL-friendly slug identifier. This endpoint is typically used for public-facing booking interfaces.
- [Get all spaces](https://docs.boseat.com/api-reference/venues-spaces/get-all-spaces.md): Retrieves a paginated list of all spaces for the organization. Supports optional filtering by venue ID to get spaces for a specific venue.
- [Update a specific space](https://docs.boseat.com/api-reference/venues-spaces/update-a-specific-space.md): Updates space details including name, description, capacity, type, and associated products. All fields are optional - only provided fields will be updated.
- [Create a new venue](https://docs.boseat.com/api-reference/venues/create-a-new-venue.md): Creates a new venue (location) for the organization. A venue contains one or more spaces and defines operating hours, address, and venue type. The venue label must be unique within the organization.
- [Delete a venue](https://docs.boseat.com/api-reference/venues/delete-a-venue.md): Permanently deletes a venue and all associated spaces. This action is irreversible and will remove all bookings, products, and data associated with the venue and its spaces.
- [Get a venue by ID](https://docs.boseat.com/api-reference/venues/get-a-venue-by-id.md): Retrieves detailed information about a specific venue including all spaces, opening hours, address, media files, and metadata.
- [Get all venues for the current tenant](https://docs.boseat.com/api-reference/venues/get-all-venues-for-the-current-tenant.md): Retrieves a paginated list of all venues belonging to the current organization. Results include venue details, spaces, opening hours, and associated media.
- [Update a venue](https://docs.boseat.com/api-reference/venues/update-a-venue.md): Updates venue details including name, address, opening hours, and metadata. All fields are optional - only provided fields will be updated. The Content-Location header indicates where to find the updated resource.
- [Create a new webhook](https://docs.boseat.com/api-reference/webhooks/create-a-new-webhook.md)
- [Delete a webhook by ID](https://docs.boseat.com/api-reference/webhooks/delete-a-webhook-by-id.md)
- [Delete a webhook event by ID](https://docs.boseat.com/api-reference/webhooks/delete-a-webhook-event-by-id.md)
- [Get a specific webhook event by ID](https://docs.boseat.com/api-reference/webhooks/get-a-specific-webhook-event-by-id.md)
- [Get a webhook by ID](https://docs.boseat.com/api-reference/webhooks/get-a-webhook-by-id.md)
- [List all webhook events for a given webhook ID](https://docs.boseat.com/api-reference/webhooks/list-all-webhook-events-for-a-given-webhook-id.md)
- [List all webhooks for the current tenant with pagination](https://docs.boseat.com/api-reference/webhooks/list-all-webhooks-for-the-current-tenant-with-pagination.md)
- [Retry sending a specific webhook event](https://docs.boseat.com/api-reference/webhooks/retry-sending-a-specific-webhook-event.md)
- [Send a test webhook event](https://docs.boseat.com/api-reference/webhooks/send-a-test-webhook-event.md)
- [Update an existing webhook](https://docs.boseat.com/api-reference/webhooks/update-an-existing-webhook.md)
- [Authentication](https://docs.boseat.com/getting-started/authentication.md): Obtain OAuth2 tokens and use them with the Boseat API
- [Errors](https://docs.boseat.com/getting-started/errors.md): Understand error formats, correlation IDs, and retry guidance
- [Introduction](https://docs.boseat.com/getting-started/introduction.md): Overview of the Boseat API and common use cases
- [Quickstart](https://docs.boseat.com/getting-started/quickstart.md): Make your first calls to search availability and create a booking
- [Error Handling](https://docs.boseat.com/guides/error-handling.md): Interpret error codes, correlation IDs, and retries
- [Pagination](https://docs.boseat.com/guides/pagination.md): Use page/limit to navigate large result sets
- [Rate Limiting](https://docs.boseat.com/guides/rate-limiting.md): Understand limits, headers, and safe retry patterns
- [Connect](https://docs.boseat.com/integrations/google-calendar/connect.md): Display inline code and code blocks
- [Supported Integrations](https://docs.boseat.com/integrations/supported.md): Available integrations and their status
- [Introduction](https://docs.boseat.com/integrations/webhooks/introduction.md)
- [Boseat Developer Docs](https://docs.boseat.com/introduction.md): Build booking experiences with the Boseat API
- [Settings](https://docs.boseat.com/organization/settings.md): Add image, video, and other HTML elements
- [Creating a Booking](https://docs.boseat.com/tutorials/creating-a-booking.md): Check availability and create a booking with customer details
- [Handling Payments](https://docs.boseat.com/tutorials/handling-payments.md): Work with invoices and Stripe-powered payments
- [Managing Resources](https://docs.boseat.com/tutorials/managing-resources.md): Create and manage venues, spaces, and products
- [Webhook Setup](https://docs.boseat.com/tutorials/webhook-setup.md): Subscribe to events and verify webhook signatures
- [Customize Widget](https://docs.boseat.com/widgets/customize.md): Theme and style the booking widget to match your brand
- [Integrate Widget](https://docs.boseat.com/widgets/integrate.md): Embed the Boseat booking widget using an iframe
- [WordPress Extension](https://docs.boseat.com/widgets/wordpress.md): Embed the Boseat widget in WordPress sites

## OpenAPI Specs

- [openapi](https://docs.boseat.com/api-reference/openapi.json)