> ## 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 all user's buy orders

> Returns active buy orders for the authenticated user across all items. Ordered by `buyorder.id DESC`; only returns buy orders where `amount != 0`.

**Permission:** Connected + API.



## OpenAPI

````yaml /openapi.json get /user/getBuyorder
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/getBuyorder:
    get:
      tags:
        - Buy Orders
      summary: Get all user's buy orders
      description: >-
        Returns active buy orders for the authenticated user across all items.
        Ordered by `buyorder.id DESC`; only returns buy orders where `amount !=
        0`.


        **Permission:** Connected + API.
      operationId: getAllUserBuyOrders
      parameters:
        - $ref: '#/components/parameters/PageParam'
        - $ref: '#/components/parameters/CountParam'
        - $ref: '#/components/parameters/SearchParam'
        - name: undercut
          in: query
          description: Filter to buy orders below the current lowest sale price
          schema:
            type: boolean
      responses:
        '200':
          description: Buy orders
          content:
            application/json:
              example:
                err: false
                success: true
                content:
                  values:
                    - id: 98765
                      itemid: 12345
                      price: 15000
                      amount: 3
                      name: Burning Flames Team Captain
                      game: 440
                  count:
                    nb: 15
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiError'
                  - type: object
                    properties:
                      content:
                        type: object
                        properties:
                          values:
                            type: array
                            items:
                              $ref: '#/components/schemas/BuyOrder'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    PageParam:
      name: page
      in: query
      description: Zero-based page number (offset = page x page size).
      schema:
        type: integer
        default: 0
    CountParam:
      name: count
      in: query
      description: Results per page.
      schema:
        type: integer
        default: 10
    SearchParam:
      name: search
      in: query
      description: Search filter (minimum 3 characters).
      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.
    BuyOrder:
      type: object
      description: A standing buy order.
      properties:
        id:
          type: integer
        itemid:
          type: integer
        price:
          type: integer
          description: Price per item in cents.
        amount:
          type: integer
          description: Quantity requested.
        name:
          type: string
        game:
          type: integer
  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
    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

````