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

# The multi-store group's cross-store collection links

> Every collection linked across two or more stores of the group, plus every live collection of every store (to label them). The caller must belong to the group (a superuser may read any). Read-only.



## OpenAPI

````yaml /api-reference/openapi/lite.json get /multi-store/collection-mappings/{group_id}
openapi: 3.1.0
info:
  title: Search & Merchandising API
  version: 1.0.0
  description: >-
    REST API behind Depict: Search & Merchandising, the native Shopify app:
    onboarding, collections, boost & bury, dashboards, A/B testing and
    multi-store management. Endpoints are served under the /api/lite prefix and
    are authenticated with the Shopify session token that App Bridge issues to
    the embedded app.
servers:
  - url: /api/lite
security:
  - ShopifySessionToken: []
paths:
  /multi-store/collection-mappings/{group_id}:
    get:
      summary: The multi-store group's cross-store collection links
      description: >-
        Every collection linked across two or more stores of the group, plus
        every live collection of every store (to label them). The caller must
        belong to the group (a superuser may read any). Read-only.
      operationId: multiStoreCollectionMappings
      parameters:
        - schema:
            type: string
            format: uuid
            description: >-
              The multi-store group's uuid (the merchant's
              `multi_store_group_id`).
          required: true
          description: >-
            The multi-store group's uuid (the merchant's
            `multi_store_group_id`).
          name: group_id
          in: path
      responses:
        '200':
          description: The group's connections and collections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiteMultiStoreCollectionResponse'
        '400':
          description: '`group_id` is not a uuid.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '401':
          description: Not authenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '403':
          description: Authenticated, but this identity may not call the API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '404':
          description: The caller is not in this group (or the group is unknown).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '500':
          description: Internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
components:
  schemas:
    LiteMultiStoreCollectionResponse:
      type: object
      properties:
        connections:
          type: array
          items:
            $ref: '#/components/schemas/LiteMultiStoreCollectionMappings'
          description: >-
            Cross-store connections, sorted by group_collection_id; a collection
            in one store only is not listed.
        collections:
          type: array
          items:
            $ref: '#/components/schemas/LiteMultiStoreCollection'
          description: >-
            Every live collection of every store in the group, to label the
            connections.
      required:
        - connections
        - collections
    Detail:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
      description: 'Every 4xx/5xx body: `{detail}`.'
    LiteMultiStoreCollectionMappings:
      type: object
      properties:
        group_collection_id:
          type: string
          description: The id shared by one collection's copies across the group.
        collections:
          type: array
          items:
            $ref: '#/components/schemas/LiteMultiStoreCollectionMapping'
          description: >-
            One entry per store holding a copy (always two or more), in the
            group's store order.
      required:
        - group_collection_id
        - collections
    LiteMultiStoreCollection:
      type: object
      properties:
        merchant_id:
          type: string
        collection_id:
          type: string
        title:
          type: string
        handle:
          type: string
        image_urls:
          type: array
          items:
            type: string
      required:
        - merchant_id
        - collection_id
        - title
        - handle
        - image_urls
    LiteMultiStoreCollectionMapping:
      type: object
      properties:
        merchant_id:
          type: string
        collection_id:
          type: string
        replication_merchant_id:
          type:
            - string
            - 'null'
      required:
        - merchant_id
        - collection_id
        - replication_merchant_id
  securitySchemes:
    ShopifySessionToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Shopify App Bridge session token of the embedded Depict: Search &
        Merchandising app. The shop in the token determines the merchant;
        merchant_id parameters must belong to that shop.

````