> ## 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. # Get an order after ordering > Auth: optional. This endpoint allows a customer to access an order via the **order number** after placing it. This can be authenticated either anonymously via the order `access_token` or via customer login. ## OpenAPI ````yaml /developers/openapi/customer.openapi.json get /api/v1/orders/{order_number} 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/orders/{order_number}: parameters: - schema: type: string name: order_number in: path required: true description: number (not the id!) of the order get: tags: - Orders summary: Get an order after ordering description: >- Auth: optional. This endpoint allows a customer to access an order via the **order number** after placing it. This can be authenticated either anonymously via the order `access_token` or via customer login. operationId: get-orders-record parameters: - schema: type: string in: query name: access_token description: Access token to access an order anonymously required: true - schema: type: string enum: - bookings - bookings.booking_add_ons.add_on - bookings.resource - bookings.resource.parent - bookings.resource.parent.cover_image - bookings.resource.settings - bookings.service - bookings.service.add_ons - bookings.sub_bookings.resource - bookings.sub_bookings.service - bookings.resource.cover_image - bookings.cancellation_policy - customer - customer.address - voucher - organization - organization.logo_image - organization.legal_documents - invoice - invoice.items - invoice_history - invoice_history.items - sub_orders - sub_orders.bookings - last_payment - last_payment.method - sub_orders - sub_orders.bookings - sub_orders.organization - sub_orders.organization.legal_documents in: query name: include explode: false - schema: type: string in: query name: sort - name: filter[search] in: query schema: type: string - schema: type: string in: query name: filter[number] - name: filter[status] in: query schema: type: string - schema: type: string in: query name: filter[start_date] - schema: type: string in: query name: filter[end_date] 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: '2008375' attributes: number: BO85985688 currency: EUR total: 249 net_amount: 209.24 tax_amount: 39.76 discount_amount: 0 status: open access_token: tQZT6eecWtCcpBRotLiuDhedMc04Uz expires_at: null created_at: '2021-09-24T09:45:37+00:00' updated_at: '2021-09-24T09:46:09+00:00' links: self: https://b.anny.co/api/v1/orders/2008375 meta: download_url: >- https://b.anny.co/downloads/order-confirmation/2008375?access_token=tQZT6eecWtCcpBRotLiuDhedMc04Uz voucher_code: null is_base_order: false payment_flow: pay-offline with relationships: value: data: type: orders id: '2008375' attributes: number: BO85985688 currency: EUR total: 249 net_amount: 209.24 tax_amount: 39.76 discount_amount: 0 status: open access_token: tQZT6eecWtCcpBRotLiuDhedMc04Uz expires_at: null created_at: '2021-09-24T09:45:37+00:00' updated_at: '2021-09-24T09:46:09+00:00' relationships: bookings: data: - type: bookings id: '3705932' customer: data: type: customers id: '405278' invoice_history: data: - type: invoices id: '1167111' organization: data: type: organizations id: '734' last_payment: data: null sub_orders: data: [] links: self: https://b.anny.co/api/v1/orders/2008375 meta: download_url: >- https://b.anny.co/downloads/order-confirmation/2008375?access_token=tQZT6eecWtCcpBRotLiuDhedMc04Uz voucher_code: null is_base_order: false payment_flow: pay-offline included: - 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: '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 relationships: 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: resources id: '22232' attributes: slug: airLK81OPAI6mzwPE6CmSlNSUjcDJy name: Heinrich Simmon 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: 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: 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-22T13:47:07+00:00' access_code: null meta: resource_list: Leadership Coach min_duration_total: 249 - type: bookings id: '3705932' attributes: number: BB53057994 status: accepted is_blocker: false start_date: '2021-10-01T11:00:00+00:00' end_date: '2021-10-01T15:00:00+00:00' blocker_start_date: '2021-10-01T11:00:00+00:00' blocker_end_date: '2021-10-01T15:00:00+00:00' description: >- Florian Schmitt - Coaching: Leadership - Empower Your Employees charged_duration: 240 weight: 1 currency: EUR total: 249 code: PpWb076kUjC4d6v5 subtotal: 249 charged_total: 249 charged_subtotal: 249 starting_fee: 0 customer_note: null created_at: '2021-09-24T09:45:37+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: '22232' service: data: type: services id: '2800' sub_bookings: data: [] cancellation_policy: data: null meta: [] - type: customers id: '405278' attributes: locale: de title: null given_name: Florian family_name: Schmitt full_name: Florian Schmitt sex: 0 birth_date: null email: florian.schmitt@anny.co mobile: '+491701234567' phone: null company: null custom_entry_map: {} created_at: '2021-09-22T10:14:01+00:00' - type: items id: '2545789' attributes: title: >- Coaching: Leadership - Empower Your Employees, Leadership Coach (Heinrich Simmon): 01.10.2021 13:00 - 01.10.2021 17:00 (CET) subtitle: null quantity: 1 single_gross_amount: 249 single_net_amount: 209.24 single_tax_amount: 39.76 gross_amount: 249 net_amount: 209.24 tax_amount: 39.76 tax_rate: 19 currency: EUR created_at: '2021-09-24T09:45:37+00:00' updated_at: '2021-09-24T09:45:37+00:00' relationships: document: [] product: [] - type: invoices id: '1167111' attributes: number: null currency: EUR is_cancellation: false is_credit: false has_payment: false recipient: |- Florian Schmitt Jülicher Straße 68 52070 Aachen DE invoicing_party: |- Workspace GmbH Jülicher Straße 68 52070 Aachen DE total: 249 net_amount: 209.24 tax_amount: 39.76 status: draft access_token: K5y0mAeNeeHoniWZ4t9KAk0pJhcs25 locked: false issued_at: '2021-10-01T15:00:00+00:00' due_date: '2021-10-15T15:00:00+00:00' created_at: '2021-09-24T09:45:37+00:00' updated_at: '2021-09-24T09:46:09+00:00' relationships: items: data: - type: items id: '2545789' reference: [] meta: download_url: >- https://b.anny.co/accounting/invoices/1167111?access_token=K5y0mAeNeeHoniWZ4t9KAk0pJhcs25&locale=en - 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: logo_image: data: null meta: settings: organizeResourcesBy: category checkout: additionalFields: [] additionalRequiredFields: [] preferFormalSalutation: false meta_settings: organizeResourcesBy: category checkout: additionalFields: [] additionalRequiredFields: [] preferFormalSalutation: false 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 ````