> ## 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.

# Create plan-subscription



## OpenAPI

````yaml /developers/openapi/customer.openapi.json post /api/v1/plan-subscriptions
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/plan-subscriptions:
    post:
      tags:
        - Plan Subscriptions
      summary: Create plan-subscription
      operationId: create-plan-subscriptions
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              type: object
        required: true
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/plan-subscriptions.v1'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '422':
          description: Unprocessable Entity
components:
  schemas:
    plan-subscriptions.v1:
      $schema: https://json-schema.org/draft/2020-12/schema
      x-version: 1.1.0
      title: PlanSubscription
      type: object
      description: >-
        A subscription to a plan, providing recurring access to services and
        quotas.
      x-tags:
        - Models
      properties:
        id:
          type: string
        type:
          type: string
          default: plan-subscriptions
        attributes:
          type: object
          properties:
            name:
              type: string
              description: Subscription name
            description:
              type:
                - string
                - 'null'
              description: Description
            status:
              type: string
              enum:
                - active
                - trialing
                - past_due
                - canceled
                - expired
                - suspended
                - pending
              description: Subscription status
            price:
              type: number
              description: Current price
            effective_price:
              type: number
              description: Effective price after discounts
            display_price:
              type: string
              description: Formatted display price
            currency:
              type: string
              description: ISO 4217 currency code
            region:
              type: string
              description: Payment region
            is_net_price:
              type: boolean
              description: Whether price is net
            next_action:
              type:
                - string
                - 'null'
              description: Next required action
            next_action_at:
              type:
                - string
                - 'null'
              description: Next action timestamp
            trial_starts_at:
              type:
                - string
                - 'null'
              description: Trial start
            trial_ends_at:
              type:
                - string
                - 'null'
              description: Trial end
            starts_at:
              type:
                - string
                - 'null'
              description: Subscription start
            ends_at:
              type:
                - string
                - 'null'
              description: Subscription end
            suspended_at:
              type:
                - string
                - 'null'
              description: Suspension timestamp
            suspended_until:
              type:
                - string
                - 'null'
              description: Suspended until
            next_billed_at:
              type:
                - string
                - 'null'
              description: Next billing date
            is_billed_offline:
              type: boolean
              description: Whether billed offline
            credited_amount:
              type: number
              description: Credited amount
            cancels_at:
              type:
                - string
                - 'null'
              description: Scheduled cancellation date
            canceled_at:
              type:
                - string
                - 'null'
              description: Cancellation timestamp
            min_cancels_at:
              type:
                - string
                - 'null'
              description: Earliest possible cancellation date
            auto_renewal:
              type: boolean
              description: Whether auto-renewing
            billing_email:
              type:
                - string
                - 'null'
              description: Billing email
            signup_fee:
              type: number
              description: One-time signup fee
            relative_discount:
              type: number
              description: Percentage discount
            absolute_discount:
              type: number
              description: Fixed discount amount
            notice_period:
              type: string
              description: Notice period
            approved_at:
              type:
                - string
                - 'null'
              description: Approval timestamp
            rejected_at:
              type:
                - string
                - 'null'
              description: Rejection timestamp
            custom_entry_map:
              type:
                - object
                - 'null'
              description: Custom field entries
            created_at:
              type:
                - string
                - 'null'
              description: Creation timestamp
            charged_at:
              type:
                - string
                - 'null'
              description: Last charge timestamp
        links:
          $ref: '#/components/schemas/links.v1'
        relationships:
          type: object
          properties:
            plan:
              type: object
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: The subscription plan
            subscriber:
              type: object
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Subscriber (organization or customer account)
            payment_setup:
              type: object
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Payment method setup
            invoices:
              type: object
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Subscription invoices
            usage:
              type: object
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Usage records
            owner:
              type: object
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: The owning organization
            customer:
              type: object
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Associated customer
            document_acceptances:
              type: object
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
              description: Legal document acceptances
            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'
        meta:
          type: object
          properties:
            usage_summary:
              type: object
              description: Usage summary (requires ?include_summary)
    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

````