> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a product group

> Get a product group by ID.

<sup>Required permissions: `product-group:read`</sup>

Get a single product group by ID.


## OpenAPI

````yaml get /catalogue/product-groups/{id}
openapi: 3.1.0
info:
  title: Fynn API
  description: ''
  termsOfService: https://www.fynn.eu/tos
  contact:
    name: Fynn UG (haftungsbeschränkt)
    url: https://www.fynn.eu
    email: hi@fynn.eu
  license:
    name: Proprietary
    url: https://www.fynn.eu/license
  version: 0.0.0
servers:
  - url: https://coreapi.io
    description: Production
  - url: https://preview.coreapi.io
    description: Sandbox
security:
  - JWT: []
tags: []
paths:
  /catalogue/product-groups/{id}:
    parameters: []
    get:
      tags:
        - ProductGroup
      summary: Get a product group
      description: |-
        Get a product group by ID.

        <sup>Required permissions: `product-group:read`</sup>
      operationId: getProductGroup
      parameters:
        - name: id
          in: path
          description: ProductGroup identifier
          required: true
          schema:
            type: string
      responses:
        '200':
          description: ProductGroup resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroup-ProductGroupDetail'
        '404':
          description: Resource not found
      security:
        - JWT:
            - product-group:read
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X GET \
             /catalogue/product-groups/{id} \
             --header "Authorization: Bearer <token>"
components:
  schemas:
    ProductGroup-ProductGroupDetail:
      $ref: '#/components/schemas/ProductGroup-ProductGroupRead'
    ProductGroup-ProductGroupRead:
      type: object
      description: A product group for up- and downgrades
      properties:
        id:
          readOnly: true
          example: ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b
          type: string
        name:
          type: string
          example: SaaS Packages
        enabled:
          example: true
          type: boolean
        forceSameBillingInterval:
          type: boolean
          description: >-
            If true, customers can only switch between plans with the same
            billing interval
          example: false
        memberships:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupMembership-ProductGroupRead'
        createdAt:
          readOnly: true
          type: string
          format: date-time
        updatedAt:
          readOnly: true
          type: string
          format: date-time
    ProductGroupMembership-ProductGroupRead:
      type: object
      description: A membership tier within a product group
      properties:
        id:
          readOnly: true
          example: ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b
          type: string
        product: 5eeb70e3-9b5d-43cb-9c01-59bf77dbebc4
        pricePlans:
          type: array
          items: 3ed7b86b-6c57-4f2a-86e1-464fe58b0d0d
        position:
          type: integer
          description: >-
            Position in the group. Lower = cheaper tier, higher = more expensive
            tier
        label:
          type: string
          description: Display label for this membership
          example: Pro
        upgradeable:
          type: boolean
          description: Whether upgrade to higher positions is allowed
        downgradeable:
          type: boolean
          description: Whether downgrade to lower positions is allowed
        changeTiming:
          type: string
          enum:
            - immediately
            - end_of_period
          description: When the change takes effect
        creditType:
          type: string
          enum:
            - full
            - pro_rata
            - last_invoiced
            - none
          description: How unused time is credited (only for immediate changes)
  securitySchemes:
    JWT:
      type: http
      scheme: bearer

````