> ## 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 bot accounts

> Returns the full list of Mannco.store bot accounts with their Steam IDs, availability status, free inventory space, and per-game item counts.

Use the `steamid` values to safely auto-accept incoming trade offers: an offer coming from one of these Steam IDs is a genuine Mannco.store bot.

**Permission:** Public. No authentication required.



## OpenAPI

````yaml /openapi.json get /utils/bots
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
  - name: Utils
    description: Public utility endpoints
paths:
  /utils/bots:
    get:
      tags:
        - Utils
      summary: Get bot accounts
      description: >-
        Returns the full list of Mannco.store bot accounts with their Steam IDs,
        availability status, free inventory space, and per-game item counts.


        Use the `steamid` values to safely auto-accept incoming trade offers: an
        offer coming from one of these Steam IDs is a genuine Mannco.store bot.


        **Permission:** Public. No authentication required.
      operationId: getBots
      responses:
        '200':
          description: List of bot accounts
          content:
            application/json:
              example:
                err: false
                success: true
                content:
                  bots:
                    - id: 1
                      name: 'Mannco | Bot #0001'
                      steamid: '76561198399972772'
                      status: 0
                      freespaceSteam: 2935
                      disabled: 0
                      Creationdate: June 28, 2017
                      TF2: 0
                      CSGO: 609
                      RUST: 1984
                      DOTA: 1983
                    - id: 2
                      name: 'Mannco | Bot #0002'
                      steamid: '76561198399987802'
                      status: 1
                      freespaceSteam: 1789
                      disabled: 0
                      Creationdate: June 28, 2017
                      TF2: 0
                      CSGO: 498
                      RUST: 1995
                      DOTA: 1972
                  count: 532
              schema:
                type: object
                properties:
                  err:
                    type: boolean
                  success:
                    type: boolean
                  content:
                    type: object
                    properties:
                      bots:
                        type: array
                        items:
                          $ref: '#/components/schemas/Bot'
                      count:
                        type: integer
                        description: Total number of bot accounts returned
        '500':
          $ref: '#/components/responses/ServerError'
      security: []
components:
  schemas:
    Bot:
      type: object
      description: >-
        A Mannco.store bot account. Trade offers sent from its `steamid` are
        genuine and can be safely auto-accepted.
      properties:
        id:
          type: integer
          description: Internal bot identifier.
        name:
          type: string
          description: 'Display name of the bot, e.g. "Mannco | Bot #0001".'
        steamid:
          type: string
          description: >-
            The bot's 64-bit Steam ID. Match incoming trade offers against this
            value.
        status:
          type: integer
          description: Bot status. 1 = disabled, 0 = active.
        freespaceSteam:
          type: integer
          description: Number of free item slots left in the bot's Steam inventory.
        disabled:
          type: integer
          description: Whether the bot is disabled. 1 = disabled, 0 = active.
        Creationdate:
          type: string
          description: Human-readable date the bot account was created.
        TF2:
          type: integer
          description: Number of Team Fortress 2 (App ID 440) items held by the bot.
        CSGO:
          type: integer
          description: Number of CS2 / CS:GO (App ID 730) items held by the bot.
        RUST:
          type: integer
          description: Number of Rust (App ID 252490) items held by the bot.
        DOTA:
          type: integer
          description: Number of Dota 2 (App ID 570) items held by the bot.
    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:
    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

````