> ## Documentation Index > Fetch the complete documentation index at: https://docs.anny.co/llms.txt > Use this file to discover all available pages before exploring further. # Add booking to order > This endpoint allows to add bookings to an order with status "draft". After the booking has changed the status, no more changes are possible from the customer side. There does not have to exist an order beforehand, because it is created as soon as the first booking is added. ## OpenAPI ````yaml /developers/openapi/customer.openapi.json post /api/v1/order/bookings openapi: 3.1.0 info: title: customer-api version: '1.0' contact: name: anny GmbH url: anny.co email: support@anny.co description: >- The Customer API is the **public booking surface** for end-user facing applications. It covers everything a customer can see and do — searching availability, placing bookings, managing their account, and more. --- ## When to use the Customer API Use the Customer API when you are **building something your customers interact with directly**: - **Custom booking flow** — embed a fully branded booking experience inside your own app or website instead of redirecting to anny - **Headless checkout** — drive the cart, checkout, and payment steps entirely from your own frontend - **Custom confirmation pages** — retrieve booking and order details after checkout to render a tailored confirmation - **Opening hours and availability on public pages** — display live schedule data on your website with no authentication required - **White-label experiences** — build lobby screens, kiosks, or mobile apps on top of the Customer API Many endpoints work **without any authentication**. For a custom OAuth2 client to authenticate your own users, contact [support@anny.co](mailto:support@anny.co) with your use case. --- ## Authentication — Optional Auth Most Customer API endpoints work without a token. Providing a customer bearer token unlocks personal data and additional actions: | Auth state | What's accessible | |---|---| | Anonymous | Availability, public resource/service info, booking lookup by number, checkout | | Customer token | Own bookings, account data, communities, passes, queue tickets | ``` Authorization: Bearer {customer_access_token} ``` To authenticate your own users, you need a custom OAuth2 client — contact [support@anny.co](mailto:support@anny.co). See the [Authentication guide](/developers/guides/authentication) for the full token flow. --- ## Customer API vs Admin API | Feature | Customer API | Admin API | |---|---|---| | **Use case** | End-user apps, booking widgets | Server-side automation, backend tooling | | **Auth** | Optional — many endpoints work without a token | Required — API token or OAuth2 | | **Identifiers** | Slugs, booking numbers, order numbers | Immutable UUIDs and integer IDs | | **Access** | Public and customer-owned data only | Full read/write | → [Go to the Admin API](/developers/api-reference/admin) --- ## Resource Identifiers The Customer API uses **human-readable identifiers** that appear in booking URLs: | Entity | Identifier | Example | |---|---|---| | Resources | Slug | `conference-room-berlin` | | Services | Slug | `hourly-desk-booking` | | Organizations | Slug | `acme-gmbh` | | Bookings | Booking number | `BB123456789` | | Orders | Order number | `BO123456789` | Use the Admin API if you need immutable internal IDs for storage in external systems. --- ## Starting Points | Guide | What it covers | |---|---| | [Getting Started](/developers) | First steps and quickstart | | [JSON:API Conventions](/developers/guides/json-api-conventions) | Request and response format | | [Authentication](/developers/guides/authentication) | Customer token flow, OAuth2, anonymous access | | [Availability & Booking Search](/developers/guides/availability) | Search open slots, filter by service and resource | | [Customer Booking Lifecycle](/developers/guides/customer/booking-lifecycle) | View, modify, and cancel bookings | | [Order & Checkout Flow](/developers/guides/customer/checkout) | Cart, checkout steps, payment | | [Plans & Subscriptions](/developers/guides/customer/plans-subscriptions) | Membership plans and recurring billing | | [Communities & Access Control](/developers/guides/customer/communities) | Community membership and access gates | | [Waitlist](/developers/guides/customer/waitlist) | Join and manage waitlists | --- ## Base URLs | Environment | URL | |---|---| | Production | `https://b.anny.co` | | Gov-Cloud | `https://b.anny.eu` | termsOfService: https://anny.co/terms-of-use x-logo: url: https://cdn.anny.co/cms/anny_logo_main_colour_blue_4865e76654.svg altText: anny logo href: https://anny.co servers: - url: https://b.anny.co description: Production - url: https://b.anny.eu description: Gov-Cloud security: [] tags: - name: Account Passes - name: Account Skills - name: Addresses - name: Availability - name: Booking Bundles - name: Booking Passes - name: Booking Quota Grants - name: Bookings - name: Communities - name: Community Accounts - name: Community Invites - name: Customer Accounts - name: Favorites - name: Orders - name: Organizations - name: Plan Subscriptions - name: Properties - name: Queues - name: Queue Tickets - name: Resources - name: Services - name: Waitlist paths: /api/v1/order/bookings: post: tags: - Orders summary: Add booking to order description: >- This endpoint allows to add bookings to an order with status "draft". After the booking has changed the status, no more changes are possible from the customer side. There does not have to exist an order beforehand, because it is created as soon as the first booking is added. operationId: post-order-bookings parameters: - schema: type: string enum: - customer - customer.address - invoice - invoice.items - customer - voucher - bookings - bookings.service - bookings.booking_add_ons.add_on - bookings.sub_bookings.resource - bookings.sub_bookings.service - bookings.resource.organization - bookings.resource - bookings.resource.cover_image - bookings.resource.organization.legal_documents in: query name: include description: Allows to include allowed resources in the response requestBody: content: application/vnd.api+json: schema: type: object properties: resource_id: type: string description: id of the resource that should be booked service_id: type: string description: >- Id of the service which should be booked. When no id is provided, the default service is taken. start_date: type: string format: date description: atomic date time string end_date: type: string format: date-time description: atomic date time string description: type: string description: > The description which will be associated with the bookings resource. It is conditionally required. customer_note: type: string description: | A note from the customer which is attented to the booking booking_add_ons: type: array description: List of add ons items: type: object properties: add_on_id: type: string quantity: type: number required: - add_on_id - quantity sub_bookings: type: array uniqueItems: true description: | List of sub bookings items: type: object properties: resource_id: type: string service_id: type: string description: >- This is optional. When nothing is sent, the default service will be taken. quantity: type: number quantity: type: number required: - resource_id - start_date - end_date examples: default: value: resource_id: '22233' service_id: '2800' start_date: '2021-10-15T09:00:00+02:00' end_date: '2021-10-15T13:00:00+02:00' description: '' customer_note: '' booking_add_ons: - add_on_id: '239' quantity: 3 sub_bookings: - resource_id: '21888' service_id: '2777' quantity: 1 quantity: 1 custom_fields: {} description: '' responses: '200': description: OK content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/orders.v1' examples: Full example: value: data: type: orders id: '2012707' attributes: number: BO39099858 currency: EUR total: 277 net_amount: 232.77 tax_amount: 44.23 discount_amount: 0 status: draft access_token: fCbsam8YHC4Ant65vQ7VCOkY3mFA4D expires_at: '2021-09-24T14:20:50+00:00' created_at: '2021-09-24T14:05:50+00:00' updated_at: '2021-09-24T14:05:51+00:00' relationships: bookings: data: - type: bookings id: '3717324' customer: data: null sub_orders: data: - type: orders id: '2012708' links: self: https://b.anny.co/api/v1/orders/2012707 meta: download_url: >- https://b.anny.co/downloads/order-confirmation/2012707?access_token=fCbsam8YHC4Ant65vQ7VCOkY3mFA4D voucher_code: null is_base_order: true payment_flow: pay-offline pay_now_amount: 0 included: - type: add-ons id: '239' attributes: name: Vegan Food description: >-

We will ensure all snacks offered will be vegan.

plain_description: We will ensure all snacks offered will be vegan. customer_notice: 'Select # of vegan attendees' lead_time: 0 is_third_party: false currency: EUR tax_rate: 19 price: 0 - type: booking-add-ons id: '795' attributes: quantity: 3 total: 0 relationships: add_on: data: type: add-ons id: '239' - type: resources id: '22230' attributes: slug: lc name: Leadership Coach description: null plain_description: '' availabilityMode: null continuous: true color: null auto_accept_bookings: true timezone: Europe/Berlin quantity: 3 staggered_quantity: 3 max_booking_quantity: 1 has_children: true available_from: '2021-08-31T22:00:00+00:00' available_to: null meta: settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: true requiresLogin: false requiresLoginReason: null verifyGuestEmail: false checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 meta_settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: true requiresLogin: false requiresLoginReason: null verifyGuestEmail: false checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 zoom: false - type: images id: '8685' attributes: url: >- https://cdn.booking-buddy.de/public/images/gallery/large/hW89Tc5fjhp0SBpR7PIzkTNOe.jpg copyright: '' width: 1920 height: 1080 order_index: 0 preview_image_base64: >- data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD//gA7Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2ODApLCBxdWFsaXR5ID0gOTAK/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgACwAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A+yrP9pGBfDfirVPsVzIPD7zeYgUZlVTEBs3FRuxL0z26mvnb9mb9tSz8P+GfEumX0N/d3P8AaEurwTXs4l/dSyorRMSQQRuU8A8lz7VtfCu3TWdDstNvgbqxm01zJBKSVfBQjPryAfwFfMvh/wAH6Pa+J/iAkVkqJaqEhUO2EBG4gDPqo/Kvs62VU6jaWh8tgM5dJtVI8yt+p91Xn7Wvw3l1O+S71+e1lilCYQuVcbFO5dp6ZJH4UV+cNvpNrq4ee7jaWXeV3b2Xj8CPWisHl1OOlz1v7YnLVJr5n//Z small_path: >- https://cdn.booking-buddy.de/public/images/gallery/small/hW89Tc5fjhp0SBpR7PIzkTNOe.jpg medium_path: >- https://cdn.booking-buddy.de/public/images/gallery/medium/hW89Tc5fjhp0SBpR7PIzkTNOe.jpg large_path: >- https://cdn.booking-buddy.de/public/images/gallery/large/hW89Tc5fjhp0SBpR7PIzkTNOe.jpg created_at: '2021-09-22T13:37:09+00:00' - type: resources id: '22233' attributes: slug: 6N0sHUrQyfEfDS1ANXNsD05cn3OPxR name: Corina Abt description: null plain_description: '' availabilityMode: null continuous: true color: null auto_accept_bookings: true timezone: Europe/Berlin quantity: 1 staggered_quantity: null max_booking_quantity: 1 has_children: false available_from: null available_to: null relationships: parent: data: type: resources id: '22230' cover_image: data: type: images id: '8685' meta: settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: true requiresLogin: false requiresLoginReason: null verifyGuestEmail: false checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 meta_settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: true requiresLogin: false requiresLoginReason: null verifyGuestEmail: false checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 zoom: false - type: services id: '2800' attributes: name: 'Coaching: Leadership - Empower Your Employees' slug: jrekqbe74eo9b7bwmursjki3michwt description: null hidden: false is_rental_option: false has_flexible_duration: false auto_duration: false allow_cross_schedule: false requires_booking_description: false requires_address: true requires_mobile: true allow_customer_notes: true allow_more_bookings: true charge_off_schedule: true booking_interval: 240 calculation_interval: 240 min_duration: 240 max_duration: 240 uncharged_duration: 0 is_full_day: false lead_time: 10080 padding_before: 0 padding_after: 0 advance_booking_period: 31 price: 249 starting_fee: 0 currency: EUR tax_rate: 19 default_weight: 1 created_at: '2021-09-22T13:39:17+00:00' updated_at: '2021-09-24T12:34:10+00:00' access_code: null meta: resource_list: Leadership Coach min_duration_total: 249 - type: resources id: '21888' attributes: slug: c01 name: C01 - London description:

Testbeschreibung C01

plain_description: Testbeschreibung C01 availabilityMode: null continuous: true color: null auto_accept_bookings: true timezone: Europe/Berlin quantity: 1 staggered_quantity: null max_booking_quantity: 1 has_children: false available_from: '2021-08-31T22:00:00+00:00' available_to: null meta: settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: false requiresLogin: false requiresLoginReason: null verifyGuestEmail: true checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 meta_settings: showAvailabilityCalendar: true showAvailabilityCount: true checkout: customerCanPickChildren: false requiresLogin: false requiresLoginReason: null verifyGuestEmail: true checkIn: isEnabled: false selfCheckIn: isEnabled: false disabledUntil: 15 geoCheckEnabled: true geoCheckMaxDelta: 997 allowedOverrunTime: 60 zoom: false - type: services id: '2777' attributes: name: Basic slug: mvwps18k7e0lifyxl7icid4znqdcwq description: null hidden: false is_rental_option: true has_flexible_duration: true auto_duration: false allow_cross_schedule: false requires_booking_description: false requires_address: true requires_mobile: true allow_customer_notes: true allow_more_bookings: true charge_off_schedule: true booking_interval: 15 calculation_interval: 30 min_duration: 30 max_duration: 480 uncharged_duration: 60 is_full_day: false lead_time: 60 padding_before: 15 padding_after: 15 advance_booking_period: 31 price: 3 starting_fee: 10 currency: EUR tax_rate: 19 default_weight: 1 created_at: '2021-09-20T13:42:16+00:00' updated_at: '2021-09-22T10:48:45+00:00' access_code: null meta: resource_list: C01 - London, M01 - Aachen, M02 - Köln min_duration_total: 10 - type: bookings id: '3717325' attributes: number: BB23455895 status: reserved is_blocker: false start_date: '2021-10-05T11:00:00+00:00' end_date: '2021-10-05T15:00:00+00:00' blocker_start_date: '2021-10-05T11:00:00+00:00' blocker_end_date: '2021-10-05T15:00:00+00:00' description: null charged_duration: 240 weight: 1 currency: EUR total: 28 code: IZSZSvmiV6bo7sIt subtotal: 28 charged_total: 28 charged_subtotal: 28 starting_fee: 10 customer_note: null created_at: '2021-09-24T14:05:50+00:00' canceled_at: null check_in_date: null check_out_date: null custom_entry_map: {} relationships: resource: data: type: resources id: '21888' service: data: type: services id: '2777' meta: [] - type: bookings id: '3717324' attributes: number: BB93911074 status: reserved is_blocker: false start_date: '2021-10-05T11:00:00+00:00' end_date: '2021-10-05T15:00:00+00:00' blocker_start_date: '2021-10-05T11:00:00+00:00' blocker_end_date: '2021-10-05T15:00:00+00:00' description: null charged_duration: 240 weight: 1 currency: EUR total: 277 code: bmLbbkY9Ulrs9dHg subtotal: 249 charged_total: 277 charged_subtotal: 249 starting_fee: 0 customer_note: null created_at: '2021-09-24T14:05:50+00:00' canceled_at: null check_in_date: null check_out_date: null custom_entry_map: {} relationships: booking_add_ons: data: - type: booking-add-ons id: '795' resource: data: type: resources id: '22233' service: data: type: services id: '2800' sub_bookings: data: - type: bookings id: '3717325' cancellation_policy: data: null meta: [] - type: legal-documents id: '311' attributes: title: T&C Test content:

T&C Test

document_type: terms_and_conditions - type: legal-documents id: '312' attributes: title: Privacy Test content:

Privacy Test

document_type: privacy_policy - type: organizations id: '734' attributes: slug: stadtmitte-buero name: Stadtmitte Büro live: true description: null plain_description: '' official_name: Workspace GmbH support_email: florian.schmitt@anny.co phone: null currency: EUR timezone: Europe/Berlin is_organization: true responsible_for_contents: Florian Schmitt ceo: null vat_id: null register_number: null local_court: null financial_office: null relationships: legal_documents: data: - type: legal-documents id: '311' - type: legal-documents id: '312' meta: settings: organizeResourcesBy: category checkout: additionalFields: [] additionalRequiredFields: [] preferFormalSalutation: false meta_settings: organizeResourcesBy: category checkout: additionalFields: [] additionalRequiredFields: [] preferFormalSalutation: false - type: orders id: '2012708' attributes: number: BO99655285 currency: EUR total: 277 net_amount: 232.77 tax_amount: 44.23 discount_amount: 0 status: draft access_token: pdEQU9LZBqKB7nQnhkbVBBypQJOkXB expires_at: null created_at: '2021-09-24T14:05:50+00:00' updated_at: '2021-09-24T14:05:51+00:00' relationships: bookings: data: - type: bookings id: '3717324' organization: data: type: organizations id: '734' meta: [] security: [] components: schemas: orders.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: Order type: object description: >- An order groups one or more bookings into a single transaction with payment and invoicing. x-tags: - Models properties: id: type: string type: type: string default: orders attributes: type: object properties: number: type: - string - 'null' description: Order number currency: type: string description: ISO 4217 currency code total: type: number description: Total amount including tax modification_total: type: number description: Total of modifications/adjustments net_amount: type: number description: Net amount before tax tax_amount: type: number description: Tax amount discount_amount: type: number description: Discount amount applied system_fee: type: number description: Platform system fee x-visibility: admin status: type: string enum: - pending - completed - canceled - expired description: Order status access_token: type: - string - 'null' description: Token for unauthenticated order access note: type: - string - 'null' description: Internal admin note x-visibility: admin manually_created: type: boolean description: Whether order was created manually x-visibility: admin has_payment: type: boolean description: Whether payment is associated x-visibility: admin payment_settings: type: object description: Payment configuration x-visibility: admin custom_entry_map: type: object description: Custom field entries as key-value map expires_at: type: string description: Reservation expiration timestamp start_date: type: string description: Earliest booking start date end_date: type: string description: Latest booking end date created_at: type: string description: Creation timestamp updated_at: type: string description: Last update timestamp links: $ref: '#/components/schemas/links.v1' relationships: type: object properties: bookings: type: object description: Bookings in this order properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' customer: type: object description: The order customer properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' organization: type: object description: The organization properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' invoice: type: object description: The final invoice properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' invoice_history: type: object description: Historical invoice properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' tmp_invoice: type: object description: Temporary/preview invoice properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' last_payment: type: object properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' description: Most recent payment payments: type: object description: All payments for this order properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' voucher: type: object description: Applied voucher properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' sub_orders: type: object description: Sub-orders properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' files: type: object description: Attached files properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' utm_tracker: type: object description: UTM tracking data properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' links.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: ResourceLinks x-tags: - Models type: object description: JSON:API self-link object properties: self: type: string format: uri ````