> ## 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.
# Delete a booking from an order
> This endpoint allows to delete the booking of an order that is still in status "draft". After the booking has changed the status, no more changes are possible from the customer side. If there are no more bookings in the order, the entire order is deleted.
## OpenAPI
````yaml /developers/openapi/customer.openapi.json delete /api/v1/order/bookings/{booking_id}
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/{booking_id}:
parameters:
- schema:
type: integer
name: booking_id
in: path
required: true
description: id of the booking
delete:
tags:
- Orders
summary: Delete a booking from an order
description: >-
This endpoint allows to delete the booking of an order that is still in
status "draft". After the booking has changed the status, no more
changes are possible from the customer side. If there are no more
bookings in the order, the entire order is deleted.
operationId: delete-order-bookings-record
parameters:
- schema:
type: string
enum:
- customer
- voucher
- bookings.booking_add_ons.add_on
- bookings.sub_bookings.resource
- bookings.sub_bookings.service
- bookings.service
- bookings.cancellation_policy
- bookings.resource.cover_image
- bookings.resource.parent
- sub_orders.bookings
- sub_orders.organization.legal_documents
in: query
name: include
- schema:
type: string
in: query
name: field[voucher]
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/orders.v1'
examples:
default:
value:
data:
type: orders
id: '2012917'
attributes:
number: BO36265293
currency: EUR
total: 199
net_amount: 167.23
tax_amount: 31.77
discount_amount: 0
status: draft
access_token: NK5EtluiM2L3nJlDs9sV5LhMaoPaRy
expires_at: '2021-09-24T14:30:19+00:00'
created_at: '2021-09-24T14:15:09+00:00'
updated_at: '2021-09-24T14:15:28+00:00'
relationships:
bookings:
data:
- type: bookings
id: '3717554'
customer:
data: null
sub_orders:
data:
- type: orders
id: '2012918'
links:
self: https://b.anny.co/api/v1/orders/2012917
meta:
download_url: >-
https://b.anny.co/downloads/order-confirmation/2012917?access_token=NK5EtluiM2L3nJlDs9sV5LhMaoPaRy
voucher_code: null
is_base_order: true
payment_flow: pay-offline
pay_now_amount: 0
included:
- type: images
id: '8654'
attributes:
url: >-
https://cdn.booking-buddy.de/public/images/gallery/large/GaRTAuUgqj6v9a6oAi6n6his8.jpg
copyright: ''
width: 500
height: 347
order_index: 0
preview_image_base64: >-
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD//gA7Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2ODApLCBxdWFsaXR5ID0gOTAK/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgADgAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A+n/i7+0NqHhS/mPg6yhki8O6rB/arZjb7bZ7ZUuVRW2kNE6rn5gclTyuaw9P+K+uwJo+l2Xhmfwt4h1TXIrg28gVUWx/dmYc5RCwBBHJGXbG4gnif2kNJvNM+KfhnxTYW+nNYXLzR6jbTiRXlbysGQbCAzbFA+bjKjOa6vSGt/iv4u0zS9RnvlgkMuwxSLHJDNgMsqvg5KiJcZXPJ5PFcil0kdVlZOK0PeNK+IviO9N6sFhItvbXL28c05QCdVx+8TG47Cc4zgnBOAMUV0Xw58PW3g/w4NLtZrm7EUhaS6vHDzTuVUl3IAGTnoAAMAAAUVsm+pyNK+h//9k=
small_path: >-
https://cdn.booking-buddy.de/public/images/gallery/small/GaRTAuUgqj6v9a6oAi6n6his8.jpg
medium_path: >-
https://cdn.booking-buddy.de/public/images/gallery/medium/GaRTAuUgqj6v9a6oAi6n6his8.jpg
large_path: >-
https://cdn.booking-buddy.de/public/images/gallery/large/GaRTAuUgqj6v9a6oAi6n6his8.jpg
created_at: '2021-09-21T09:37:11+00:00'
- type: resources
id: '22153'
attributes:
slug: ctc
name: Certified Team Coach
description: >-
Book a certified team coach to get you team's
collaboration to the next level.
plain_description: >-
Book a certified team coach to get you team's
collaboration to the next level.
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
relationships:
parent:
data: null
cover_image:
data:
type: images
id: '8654'
meta:
settings:
showAvailabilityCalendar: true
showAvailabilityCount: true
checkout:
customerCanPickChildren: false
requiresLogin: false
requiresLoginReason: ''
verifyGuestEmail: false
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: ''
verifyGuestEmail: false
checkIn:
isEnabled: false
selfCheckIn:
isEnabled: false
disabledUntil: 15
geoCheckEnabled: true
geoCheckMaxDelta: 997
allowedOverrunTime: 60
zoom: false
- type: services
id: '2783'
attributes:
name: 'Coaching: Effective Communication & Collaboration'
slug: stjymkaryfeu3zpdrjkipxbracoe4x
description: >-
Learn how to effectively communicate to enable
and maximize collaboration. Our coach provides you
with 3 simple guidelines to venture off into new
dimensions of collaboration.
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: 15
calculation_interval: 180
min_duration: 180
max_duration: 180
uncharged_duration: 0
is_full_day: false
lead_time: 10080
padding_before: 15
padding_after: 15
advance_booking_period: 31
price: 199
starting_fee: 0
currency: EUR
tax_rate: 19
default_weight: 1
created_at: '2021-09-21T09:53:34+00:00'
updated_at: '2021-09-22T12:31:16+00:00'
access_code: null
meta:
resource_list: Certified Team Coach
min_duration_total: 199
- type: bookings
id: '3717554'
attributes:
number: BB66568081
status: reserved
is_blocker: false
start_date: '2021-10-22T07:00:00+00:00'
end_date: '2021-10-22T10:00:00+00:00'
blocker_start_date: '2021-10-22T06:45:00+00:00'
blocker_end_date: '2021-10-22T10:15:00+00:00'
description: null
charged_duration: 180
weight: 1
currency: EUR
total: 199
code: mYDM4cbnIeooDRRN
subtotal: 199
charged_total: 199
charged_subtotal: 199
starting_fee: 0
customer_note: null
created_at: '2021-09-24T14:15:19+00:00'
canceled_at: null
check_in_date: null
check_out_date: null
custom_entry_map: {}
relationships:
booking_add_ons:
data: []
resource:
data:
type: resources
id: '22153'
service:
data:
type: services
id: '2783'
sub_bookings:
data: []
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: '2012918'
attributes:
number: BO89972352
currency: EUR
total: 199
net_amount: 167.23
tax_amount: 31.77
discount_amount: 0
status: draft
access_token: wyW93yQdteN83w6d7UYlDSGRhDGpI0
expires_at: null
created_at: '2021-09-24T14:15:09+00:00'
updated_at: '2021-09-24T14:15:28+00:00'
relationships:
bookings:
data:
- type: bookings
id: '3717554'
organization:
data:
type: organizations
id: '734'
meta: []
'204':
description: No Content
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
````