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

# List item offers



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/items
openapi: 3.0.3
info:
  title: LoLBoost Seller API
  version: 1.0.0
  description: Seller API for syncing account offers and item offers with LoLBoost.
servers:
  - url: https://api.lolboost.gg
    description: LoLBoost Seller API
security:
  - BearerAuth: []
tags:
  - name: Accounts
    description: Create, list, update, archive and bulk remove account offers.
  - name: Items
    description: Create, list, update, archive and bulk remove item offers.
  - name: Top Ups
    description: Create, list, update, archive and bulk manage top up offers.
  - name: Images
    description: Upload, list and delete seller gallery images for listings.
  - name: Webhooks
    description: Webhook payload examples for sync events.
paths:
  /api/v1/items:
    get:
      tags:
        - Items
      summary: List item offers
      parameters:
        - name: filter[search]
          in: query
          schema:
            type: string
        - name: filter[external_id]
          in: query
          schema:
            type: string
        - name: filter[status]
          in: query
          schema:
            type: string
        - name: sort
          in: query
          schema:
            type: string
            example: '-updated_at'
        - name: per_page
          in: query
          schema:
            type: integer
            example: 15
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Item'
                  meta:
                    type: object
                  links:
                    type: object
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - BearerAuth: []
components:
  schemas:
    Item:
      type: object
      properties:
        id:
          type: integer
          example: 55
        external_id:
          type: string
          example: item-123
        lolboost_item_id:
          type: integer
          example: 55
        title:
          type: string
          example: LoL Gift Item
        type:
          type: string
          example: gift
        game:
          type: string
          example: lol
        server:
          type: string
          example: EUW
        price:
          type: integer
          example: 999
        stock:
          type: integer
          example: 10
        status:
          type: string
          example: listed
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        message:
          type: string
          example: Unauthenticated.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````