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

# Get published item

> Public currently published Items with an active parent Game and an offer in the configured display zone.



## OpenAPI

````yaml scripts/reference/sources/openapi/player.json GET /v1/games/{gameId}/store/items/{itemId}
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/games/{gameId}/store/items/{itemId}:
    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 currently published Items with an active parent Game and an offer
        in the configured display zone. Bearer credentials are ignored.
        Displayed prices do not authorize purchase.
      operationId: getPublishedItem
      parameters:
        - name: includeBackgroundColor
          in: query
          required: false
          description: >-
            Opt in to creator-selected item preview backgrounds; omitted or
            false preserves the original item response.
          schema:
            type: boolean
            default: false
        - name: gameId
          in: path
          required: true
          schema:
            type: string
            minLength: 8
            maxLength: 128
            pattern: ^[A-Za-z][A-Za-z0-9_-]{7,127}$
        - name: itemId
          in: path
          required: true
          schema:
            type: string
            minLength: 8
            maxLength: 128
            pattern: ^[A-Za-z][A-Za-z0-9_-]{7,127}$
        - name: If-None-Match
          in: header
          required: false
          schema:
            type: string
      responses:
        '200':
          description: >-
            Published Item projection. Cache-Control: private, max-age=60; ETag
            supports conditional reads.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Item'
        '304':
          description: The supplied ETag matches the current projection.
        '400':
          description: Invalid identifier or pagination request.
        '404':
          description: Published resource or display-zone offer not found.
        '409':
          description: Store publication is inconsistent.
        '503':
          description: Catalog or media dependency unavailable.
      security: []
components:
  schemas:
    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.