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

# List items in a collection

> Retrieve all items within a specific collection for a game with optional filtering and sorting.



## OpenAPI

````yaml /api/openapi.json get /v2/games/{game}/{gameItemCollection}
openapi: 3.1.0
info:
  title: GameBoost
  version: 2.0.0
servers:
  - url: https://api.gameboost.com
    description: GameBoost API
security:
  - BearerTokenSecurityScheme: []
tags:
  - name: Games
    description: Games
  - name: Seller Breaks
    description: Seller Breaks
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: Account Offers
    description: Account Offers
  - name: Account Orders
    description: Account Orders
  - name: Item Offers
    description: Item Offers
  - name: Item Orders
    description: Item Orders
  - name: Currency Offers
    description: Currency Offers
  - name: Currency Orders
    description: Currency Orders
  - name: Webhooks
    description: Webhook events sent to your endpoints when specific actions occur
  - name: Gift Card Offers
    description: Gift Card Offers
  - name: Gift Card Orders
    description: Gift Card Orders
paths:
  /v2/games/{game}/{gameItemCollection}:
    get:
      tags:
        - Games
      summary: List items in a collection
      description: >-
        Retrieve all items within a specific collection for a game with optional
        filtering and sorting.
      parameters:
        - name: game
          in: path
          description: The slug of the game. Can be retrieved from the list of games.
          required: true
          schema:
            type: string
        - name: gameItemCollection
          in: path
          description: >-
            The slug of the game item collection. Can be retrieved from the list
            of the game's item types.
          required: true
          schema:
            type: string
        - name: filter[search]
          in: query
          description: Search game items by id, name, or slug
          required: false
          schema:
            type: string
        - name: filter[id]
          in: query
          description: >-
            Filter by exact id. Supports comma-separated values for multiple
            matches.
          required: false
          schema:
            type: string
            example: 3,6,9
        - name: filter[slug]
          in: query
          description: >-
            Filter by exact slug. Supports comma-separated values for multiple
            matches.
          required: false
          schema:
            type: string
            example: example
        - name: filter[variant_type]
          in: query
          description: >-
            Filter by exact variant type. Supports comma-separated values for
            multiple matches.
          required: false
          schema:
            type: string
            example: example
        - name: filter[parent_id]
          in: query
          description: >-
            Filter by exact parent id. Supports comma-separated values for
            multiple matches.
          required: false
          schema:
            type: string
            example: 504535
        - name: filter[has_variants]
          in: query
          description: Filter items that have variants
          required: false
          schema:
            type: boolean
        - name: filter[is_variant]
          in: query
          description: Filter items that are variants
          required: false
          schema:
            type: boolean
        - name: sort
          in: query
          description: Sort by field. Prefix with - for descending order.
          required: false
          schema:
            enum:
              - id
              - '-id'
              - name
              - '-name'
              - created_at
              - '-created_at'
            default: name
            type: string
            example: name
      responses:
        '200':
          description: A list of game items for a specific collection
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GameItem'
                  game_item_collection:
                    $ref: '#/components/schemas/GameItemCollection'
                  game:
                    $ref: '#/components/schemas/Game'
        '401':
          $ref: '#/components/responses/ErrorUnauthenticated'
        '404':
          $ref: '#/components/responses/ErrorNotFound'
        '429':
          $ref: '#/components/responses/ErrorRateLimited'
      security:
        - BearerToken: []
components:
  schemas:
    GameItem:
      description: Game item object representing an in-game item that can be traded
      type: object
      properties:
        id:
          description: Unique identifier for the game item
          type: integer
        name:
          description: Display name of the item
          type: string
        slug:
          description: URL-friendly identifier for the item
          type: string
        item_data:
          description: Additional game-specific item data and attributes
          type: object
          nullable: true
        parent_id:
          description: >-
            ID of the parent item if this is a variant (e.g., different skin
            colors)
          type: integer
          nullable: true
        variant_type:
          description: Type classification of the variant
          type: string
          nullable: true
        variant_name:
          description: Display name for this specific variant
          type: string
          nullable: true
        has_variants:
          description: Indicates if this item has multiple variants available
          type: boolean
          nullable: true
        is_variant:
          description: Indicates if this item is a variant of another item
          type: boolean
          nullable: true
        icon_url:
          description: URL to the item icon image for light mode
          type: string
          nullable: true
        icon_dark_url:
          description: URL to the item icon image for dark mode
          type: string
          nullable: true
    GameItemCollection:
      description: >-
        Game item collection object representing a category or group of game
        items
      type: object
      properties:
        name:
          description: Display name of the item collection
          type: string
        slug:
          description: URL-friendly identifier for the collection
          type: string
        items_count:
          description: Total number of items in this collection
          type: integer
          nullable: true
    Game:
      description: Game object representing a video game available on the platform
      type: object
      properties:
        id:
          description: Unique identifier for the game
          type: integer
        name:
          description: Display name of the game
          type: string
        slug:
          description: URL-friendly identifier for the game
          type: string
        acronym:
          description: >-
            Short acronym or abbreviation for the game (e.g., "LoL" for League
            of Legends)
          type: string
          nullable: true
        services:
          description: >-
            List of available service types for this game (e.g., accounts,
            currency, items)
          type: array
          items:
            type: string
          nullable: true
        game_item_collections:
          description: Available item collections and categories for trading in this game
          type: array
          items:
            $ref: '#/components/schemas/GameItemCollection'
          nullable: true
  responses:
    ErrorUnauthenticated:
      description: >-
        User is not authenticated, happens when the API key is missing, expired
        or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
    ErrorNotFound:
      description: Resource not found, happens when the requested resource does not exist
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Resource not found.
    ErrorRateLimited:
      description: >-
        Rate limit exceeded, happens when you exceed the rate limit for the
        endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too many requests.
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````