> ## 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 user's buy orders for an item

> Returns all active buy orders for a specific item created by the authenticated user.

**Permission:** Connected + API.



## OpenAPI

````yaml /openapi.json get /user/buyorder/{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:
  /user/buyorder/{item}:
    get:
      tags:
        - Buy Orders
      summary: Get user's buy orders for an item
      description: >-
        Returns all active buy orders for a specific item created by the
        authenticated user.


        **Permission:** Connected + API.
      operationId: getUserBuyOrderForItem
      parameters:
        - $ref: '#/components/parameters/ItemPathParam'
      responses:
        '200':
          description: Buy order
          content:
            application/json:
              example:
                err: false
                success: true
                content:
                  informations:
                    id: 98765
                    steamid: '76561198000000000'
                    itemid: 12345
                    price: 15000
                    amount: 3
                    timestamp: '1706745600'
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    ItemPathParam:
      name: item
      in: path
      required: true
      description: Item identifier (numeric ID or URL slug).
      schema:
        type: string
  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.
  responses:
    Forbidden:
      description: >-
        Forbidden. Missing/invalid JWT, blocked country, or insufficient
        permissions.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            err: true
            success: false
            content: forbidden
    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

````