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

# Find content groups containing a reference to the given object

> Reverse lookup — returns all content groups that contain a reference to the specified object. Useful for discovering which groups a given object belongs to.



## OpenAPI

````yaml /openapi/phrase-control-hub.json get /api/v1/public/references/groups
openapi: 3.0.0
info:
  version: 1.0.21
  title: Control Hub Service
  license:
    name: Proprietary
servers:
  - url: https://eu.phrase.com/control-hub/
security: []
tags:
  - name: Groups
    x-displayName: Content Groups
    description: |
      Organisation-scoped generic content groups and their object references.
  - name: Groups references
    x-displayName: Content Group References
    description: >
      Endpoints for managing content group–object references and performing
      reverse lookups.
paths:
  /api/v1/public/references/groups:
    get:
      tags:
        - Groups references
      summary: Find content groups containing a reference to the given object
      description: >-
        Reverse lookup — returns all content groups that contain a reference to
        the specified object. Useful for discovering which groups a given object
        belongs to.
      operationId: listGroupsByReference
      parameters:
        - name: objectType
          in: query
          required: true
          description: Type of the platform object
          schema:
            $ref: '#/components/schemas/GroupReferenceObjectType'
        - name: objectUid
          in: query
          required: true
          description: Identifier of the platform object
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: Content groups that contain a reference to the given object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupsByReferenceResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
components:
  schemas:
    GroupReferenceObjectType:
      type: string
      description: >
        Type of platform object being linked.


        `PLATFORM_STYLE_GUIDE`, `TMS_PROJECT` and `TMS_PROJECT_TEMPLATE` cannot
        be linked to the

        organization's SYSTEM content group — the request is rejected with a
        `422` error, code

        `Conflict`. `PLATFORM_QA_CHECK` and `PLATFORM_STYLE_RULE` are
        unaffected.


        A `TMS_PROJECT` and `TMS_PROJECT_TEMPLATE` can only belong to one
        content group at a time.

        Creating a direct reference to a second group is rejected with a `422`
        error, code

        `Conflict`; unlink it from its current group first (`DELETE
        /groups/{groupId}/references/{referenceId}`

        or `DELETE /groups/{groupId}/references`) before linking it to a new
        one.
      enum:
        - PLATFORM_STYLE_GUIDE
        - PLATFORM_STYLE_RULE
        - TMS_PROJECT
        - PLATFORM_QA_CHECK
        - TMS_PROJECT_TEMPLATE
    GroupsByReferenceResponse:
      type: object
      required:
        - groups
      properties:
        groups:
          type: array
          items:
            $ref: '#/components/schemas/Group'
    Group:
      type: object
      required:
        - id
        - name
        - createdAt
        - updatedAt
        - groupType
      properties:
        id:
          type: string
          description: Unique identifier of the content group
        name:
          type: string
          description: >-
            Content group name (not required to be unique within the
            organization)
        description:
          type: string
          description: Optional free-text description
        createdAt:
          type: string
          description: When the content group was created — timestamp (ISO-8601 format)
        updatedAt:
          type: string
          description: >-
            When the content group was last updated — timestamp (ISO-8601
            format)
        groupType:
          $ref: '#/components/schemas/GroupType'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          title: Error code
          example: NotBlank/NotFound/Error/...
          type: string
        message:
          title: Error message
          example: Organization UID cannot be null
          type: string
        args:
          title: >-
            Map of error arguments - so they are not needed to be parsed from
            the message
          type: object
          additionalProperties: true
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ErrorEntry'
          description: list of errors this error consist of
    GroupType:
      type: string
      description: >
        Whether the group is customer-created (USER) or a platform-managed
        system group (SYSTEM).

        Every organization has exactly one SYSTEM group, representing "applies
        to all content

        groups." SYSTEM groups are created automatically and cannot be created,
        updated, or

        deleted via the API — only USER groups can. Server-determined, never
        accepted on

        create/update requests.
      enum:
        - SYSTEM
        - USER
    ErrorEntry:
      required:
        - code
        - message
      properties:
        message:
          type: string
          description: Error message
        code:
          type: string
          description: Error code
        args:
          type: object
          additionalProperties: true
          description: More information about error
  responses:
    '400':
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '500':
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.