> ## 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 services of an organization ## OpenAPI ````yaml /developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/services 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/organizations/{organization_slug}/services: parameters: - schema: type: string name: organization_slug in: path required: true get: tags: - Organizations - Services summary: Get services of an organization operationId: get-organizations-record-services parameters: - schema: type: string in: query name: page[size] - schema: type: string in: query name: page[number] - schema: type: string enum: - resources - resources.cover_image - service_sub_resources - service_sub_resources.resource - service_sub_resources.resource.cover_image - sub_resources - sub_resources.cover_image - add_ons - cancellation_policy - custom_forms - custom_forms.custom_fields - tests in: query name: include description: Include services relationships - schema: type: string enum: - name - created_at - updated_at - price in: query name: sort - schema: type: boolean in: query name: filter[is_rental_option] - name: filter[search] in: query schema: type: string - schema: type: array in: query name: filter[resources] - schema: type: array in: query name: filter[ids] responses: '200': description: OK content: application/vnd.api+json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/services.v1' examples: default: value: data: - 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-21T09:33:50+00:00' access_code: null links: self: https://b.anny.co/api/v1/services/2777 meta: resource_list: C01 - London, M01 - Aachen, M02 - Köln min_duration_total: 10 - type: services id: '2781' attributes: name: Basic slug: aseddqeendzgjukfzf0wwbjlczurlt 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: 0 is_full_day: false lead_time: 60 padding_before: 15 padding_after: 15 advance_booking_period: 31 price: 0 starting_fee: 0 currency: EUR tax_rate: 19 default_weight: 1 created_at: '2021-09-21T08:51:26+00:00' updated_at: '2021-09-21T09:26:38+00:00' access_code: null links: self: https://b.anny.co/api/v1/services/2781 meta: resource_list: Conference Speaker Dongle min_duration_total: 0 - 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-21T10:00:10+00:00' access_code: null links: self: https://b.anny.co/api/v1/services/2783 meta: resource_list: Certified Team Coach min_duration_total: 199 '404': description: Not Found components: schemas: services.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: Service type: object description: >- A bookable service offered on one or more resources. Defines pricing, duration, and booking rules. x-tags: - Models properties: id: type: string type: type: string default: services attributes: type: object properties: name: type: string description: Service name local_name: type: string description: Localized name slug: type: string description: URL-friendly slug description: type: - string - 'null' description: Rich text description plain_description: type: - string - 'null' description: Plain text description email_info: type: - string - 'null' description: Email info text x-visibility: admin duration: type: integer description: Duration in minutes lead_time: type: integer description: Buffer time before booking in minutes follow_up_time: type: integer description: Buffer time after booking in minutes min_advance_time: type: integer description: Minimum advance booking time in minutes max_advance_time: type: integer description: Maximum advance booking time in minutes min_duration: type: integer description: Minimum duration for flexible bookings max_duration: type: integer description: Maximum duration for flexible bookings currency: type: string description: ISO 4217 currency code price: type: number description: Base price is_net_price: type: boolean description: Whether price is net price_hidden: type: boolean description: Whether to hide prices price_label: type: - string - 'null' description: Custom price label tax_rate: type: number description: Tax rate unit: type: string description: Pricing unit calculation_unit: type: string description: Calculation unit for pricing booking_type: type: string description: Type of booking flow is_protected: type: boolean description: Whether admin-only booking allow_personalization: type: boolean description: Whether personalization is supported require_personalization: type: boolean description: Whether personalization is required allow_participants: type: boolean description: Whether participants are supported allow_resource_selection: type: boolean description: Whether customer can choose resource allow_recurring: type: boolean description: Whether recurring bookings are supported auto_accept_bookings: type: boolean description: Whether bookings are auto-accepted requires_quota: type: boolean description: Whether a quota pass is required min_booking_quantity: type: integer description: Minimum booking quantity max_booking_quantity: type: integer description: Maximum booking quantity quota: type: integer description: Default slot capacity archived: type: boolean description: Whether archived x-visibility: admin hidden_in_list: type: boolean description: Hidden from service list x-visibility: admin public_listing: type: boolean description: Listed in public directory x-visibility: admin assignment_strategy: type: string description: Resource assignment strategy x-visibility: admin settings: type: object description: Service settings x-visibility: admin 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: organization: type: object description: Owning organization properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' cover_image: type: object description: Cover image properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' resources: type: object description: Resources this service is offered on properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' recommended_resources: type: object description: Recommended resources properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' add_ons: type: object description: Available add-ons properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' service_add_ons: type: object description: Service-add-on pivot properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' cancellation_policy: type: object description: Cancellation policy properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' legal_document_links: type: object properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' description: Required legal documents custom_form_models: type: object description: Custom checkout forms properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' schedules: type: object description: Custom schedules properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' communities: type: object description: Associated communities properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' group: type: object description: Service group properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' price_modifiers: type: object description: Price modifiers properties: data: type: array items: type: object 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 ````