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

# Get item listings

> Returns paginated listings sorted by price ascending. The variant `GET /item/listing/{item}/{userid}` filters by seller. For non-admin callers, `user` and `ip` are omitted.

**Permission:** Connected + API.



## OpenAPI

````yaml /openapi.json get /item/listing/{item}
openapi: 3.1.0
info:
  title: Mannco.store API
  description: >-
    Complete API documentation for Mannco.store - Buy and sell TF2, CS:GO, Dota
    2, Rust and Steam community items. All routes use the `api` filter. Every
    endpoint requires an `Authorization: Bearer <jwt>` token obtained from POST
    /user/login. The only exception is the login endpoint itself, which is used
    to obtain the token.
  version: 1.0.0
servers:
  - url: https://api.mannco.store
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Auth
    description: Authentication and login
  - name: Items
    description: Item details, listings, pricing, and sales graphs
  - name: Offers
    description: Create, manage, and respond to trade offers
  - name: Buy Orders
    description: Create, update, and manage buy orders
  - name: Payment
    description: Checkout sessions for balance and cart payments
  - name: Inventory
    description: 'Manage user inventory: list, price, and withdraw'
  - name: Cart
    description: Manage the shopping cart
  - name: Listing
    description: Deposit Steam items and instant sell
  - name: Trading
    description: Active and historical trades
  - name: User Account
    description: Account, balance, sessions, and history
paths:
  /item/listing/{item}:
    get:
      tags:
        - Items
      summary: Get item listings
      description: >-
        Returns paginated listings sorted by price ascending. The variant `GET
        /item/listing/{item}/{userid}` filters by seller. For non-admin callers,
        `user` and `ip` are omitted.


        **Permission:** Connected + API.
      operationId: getItemListings
      parameters:
        - $ref: '#/components/parameters/ItemPathParam'
        - $ref: '#/components/parameters/CountParam'
        - $ref: '#/components/parameters/PageParam'
        - $ref: '#/components/parameters/GameQueryParam'
      responses:
        '200':
          description: Listings
          content:
            application/json:
              example:
                err: false
                success: true
                content:
                  - id: 1
                    assetId: '987654321'
                    item_id: 5678
                    state: 1
                    price: 15000
                    game: 440
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiError'
                  - type: object
                    properties:
                      content:
                        type: array
                        items:
                          $ref: '#/components/schemas/Listing'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - bearerAuth: []
components:
  parameters:
    ItemPathParam:
      name: item
      in: path
      required: true
      description: Item identifier (numeric ID or URL slug).
      schema:
        type: string
    CountParam:
      name: count
      in: query
      description: Results per page.
      schema:
        type: integer
        default: 10
    PageParam:
      name: page
      in: query
      description: Zero-based page number (offset = page x page size).
      schema:
        type: integer
        default: 0
    GameQueryParam:
      name: game
      in: query
      description: 'Game ID filter: 440, 730, 570, 252490, or 753.'
      schema:
        type: integer
  schemas:
    ApiError:
      type: object
      description: >-
        Standard Mannco.store response envelope. `err` and `success` flag the
        outcome; the payload (or error message) is always under `content`.
      required:
        - err
        - success
      properties:
        err:
          type: boolean
          description: True when the request failed.
        success:
          type: boolean
          description: True when the request succeeded.
        content:
          description: Payload on success, or an error message/object on failure.
    Listing:
      type: object
      description: An item listed for sale.
      properties:
        id:
          type: integer
        assetId:
          type: string
          description: Steam asset ID.
        item_id:
          type: integer
        state:
          type: integer
          description: Inventory state (1 = listed for sale).
        price:
          type: integer
          description: Price in cents.
        game:
          type: integer
  responses:
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            err: true
            success: false
            content: Not found
    ServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            err: true
            success: false
            content: Internal server error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT obtained from POST /user/login

````