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

# List published store items

> Public bounded catalog of currently published Items across Games.



## OpenAPI

````yaml scripts/reference/sources/openapi/player.json GET /v1/store/items
openapi: 3.1.0
info:
  title: Summer Player Game Platform API
  version: summer.player.games/v1
  description: >-
    Public Summer Games store reads, the connected-app OAuth endpoints, and the
    signed-in player's profile and preferences.
servers:
  - url: https://api.summer.games
security:
  - playerBearer: []
paths:
  /v1/store/items:
    parameters:
      - name: includeImageVariants
        in: query
        schema:
          type: boolean
          default: false
        description: >-
          Opt in to optional image size metadata. Omitted by default for
          compatibility with strict older clients; the default image URL still
          serves the web version when available.
    get:
      description: >-
        Public bounded catalog of currently published Items across Games. Each
        entry includes its current published parent Game name. Canonical
        discovery also requires an active Game and environment attachment. Empty
        filtered pages may carry a continuation. Bearer credentials are ignored.
        Realm and display zone are configured by the server; displayed offers do
        not authorize purchase.
      operationId: listPublishedStoreItems
      parameters:
        - name: includeBackgroundColor
          in: query
          required: false
          description: >-
            Opt in to creator-selected item preview backgrounds; omitted or
            false preserves the original item projection.
          schema:
            type: boolean
            default: false
        - name: cursor
          in: query
          required: false
          description: >-
            Opaque continuation bound to global Store, realm and configured
            display zone. Public visibility is rechecked on each page.
          schema:
            type: string
            maxLength: 2048
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: If-None-Match
          in: header
          required: false
          schema:
            type: string
      responses:
        '200':
          description: >-
            Published cross-Game Item projection. Cache-Control: private,
            max-age=60; ETag supports conditional reads.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StoreItemPage'
        '304':
          description: The supplied ETag matches the current public projection.
        '400':
          description: Invalid request or cursor from another display context.
        '503':
          description: Storefront unavailable.
      security: []
components:
  schemas:
    StoreItemPage:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          maxItems: 100
          items:
            type: object
            required:
              - item
              - gameTitle
            properties:
              item:
                $ref: '#/components/schemas/Item'
              gameTitle:
                type: string
                minLength: 1
        nextCursor:
          type: string
          maxLength: 2048
    Item:
      type: object
      required:
        - itemId
        - gameId
        - name
        - description
        - tags
        - media
        - price
      properties:
        backgroundColor:
          type: string
          pattern: ^#[0-9A-Fa-f]{6}$
          description: >-
            Creator-selected preview color; omitted uses the application
            default.
        itemId:
          type: string
        gameId:
          type: string
        name:
          type: string
        description:
          type: string
        tags:
          type: array
          items:
            type: string
        media:
          type: array
          items:
            $ref: '#/components/schemas/Media'
        price:
          type: object
          required:
            - sparksAmount
            - zoneId
          properties:
            sparksAmount:
              type: integer
              format: int64
            zoneId:
              type: string
            offerId:
              type: string
    Media:
      type: object
      properties:
        assetId:
          type: string
          minLength: 1
          maxLength: 128
        kind:
          type: string
          enum:
            - IMAGE
            - VIDEO
            - MODEL_3D
        url:
          type: string
          format: uri
          description: >-
            Stable Platform URL for public IMAGE and MODEL_3D delivery; no
            redirect or signature. Images use the 1920px maximum-edge web
            version when prepared, otherwise the original. Other delivery
            references may remain signed.
        variants:
          type: array
          maxItems: 4
          description: >-
            Optional publication-scoped image representations. All share this
            media reference's expiry and visibility rules; dimensions preserve
            aspect ratio without upscaling. Sizes 128, 256 and 512 target the
            shorter edge with a four-times-size longer-edge cap (2048 pixels for
            size 512); size 1920 remains a maximum-edge rendition. Smaller
            originals retain their dimensions. Publications may omit variants
            until prepared.
          items:
            type: object
            required:
              - size
              - width
              - height
              - url
              - contentType
            properties:
              size:
                type: integer
                enum:
                  - 128
                  - 256
                  - 512
                  - 1920
              width:
                type: integer
                minimum: 1
                maximum: 2048
              height:
                type: integer
                minimum: 1
                maximum: 2048
              url:
                type: string
                format: uri
              contentType:
                type: string
                enum:
                  - image/jpeg
                  - image/png
        expiresAt:
          type: string
          format: date-time
          description: >-
            Refresh or revalidate the delivery reference by this deadline. For
            stable public IMAGE and MODEL_3D URLs this is a revalidation
            deadline, not URL invalidation. Other signed or private references
            retain their URL expiry semantics. Required for backward
            compatibility.
      required:
        - assetId
        - kind
        - url
        - expiresAt
  securitySchemes:
    playerBearer:
      type: http
      scheme: bearer
      description: >-
        A player access token. Store reads need no token. Other apps get a token
        through connected-app OAuth: register the client, let the player approve
        it on summer.games, then exchange the code at the token endpoint.

````

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