> ## Documentation Index > Fetch the complete documentation index at: https://api.csboard.com/llms.txt > Use this file to discover all available pages before exploring further. # GET /v1/p2p/inventory — ваш инвентарь CS2, готовый к выставлению > Ваши предметы CS2, по строке на каждую копию: можно ли выставить её на P2P-маркет CSBoard прямо сейчас и если нет, то почему. Первый шаг выставления через API. Эндпоинт возвращает все предметы CS2, которые мы видели в вашем инвентаре Steam, — по строке на каждую копию: `asset_id` отличает две копии одного и того же скина. `listable` показывает, можно ли опубликовать копию прямо сейчас; если нельзя, причину объясняет `reasons`. `listed` отмечает копии, у которых уже есть листинг. Передавайте `operational_asset_id` и `asset_revision` из этого ответа без изменений в [`POST /v1/p2p/listings`](/ru/api-reference/post-p2p-listings). **Требуется аутентификация.** Отправьте ключ как `Authorization: Bearer csb_pub_...`. Бесплатно — подойдёт любой действующий ключ, требований к балансу нет. ## Чтение инвентаря Для публикации нужен актуальный снимок вашего инвентаря Steam. Его состояние показывает `inventory_proof`: | `inventory_proof.status` | Значение | Что делать | | - | - | - | | `ready` | Актуальный снимок есть. | Выставляйте строки с `listable: true`. | | `pending` | Этот вызов запустил новое чтение. | Повторите запрос через `retry_after_ms`. | | `blocked` | Мы не можем прочитать ваш инвентарь. | Исправьте то, что указано в `code` — например, закрытый инвентарь или отсутствующий trade URL, — и повторите запрос. | ## Пример запроса ```bash theme={null} curl https://csboard.com/v1/p2p/inventory \ -H "Authorization: Bearer csb_pub_..." ``` ## Пример ответа ```json theme={null} { "data": [ { "operational_asset_id": "5b0c1f7e-3d2a-4c8e-9a61-2f4d8b7e1c30", "asset_revision": "sha256:fd0e6de607b774aaaf4d9cdb7e014c003ba614b03f0460b01e8c94bce034bac5", "asset_id": "38451927734", "market_hash_name": "AK-47 | Redline (Field-Tested)", "context_id": "2", "listable": true, "reasons": [], "listed": false, "listing_id": null, "listing_status": null, "snapshot_completed_at": "2026-10-02T11:58:03.000Z" }, { "operational_asset_id": "c81e2d44-9b07-4f1a-b3d5-6e2a90f4c7b8", "asset_revision": "sha256:a5b10a9006f6ebb68f8b9e81c85b5a6d1bf0f32737fc3f57a597dd01e66e0523", "asset_id": "38451927990", "market_hash_name": "Glock-18 | Water Elemental (Minimal Wear)", "context_id": "16", "listable": false, "reasons": [ { "code": "hold_not_ended", "message": "The Steam trade hold has not ended yet." } ], "listed": false, "listing_id": null, "listing_status": null, "snapshot_completed_at": "2026-10-02T11:58:03.000Z" } ], "inventory_proof": { "status": "ready", "completed_at": "2026-10-02T11:58:03.000Z", "asset_count": 2 } } ``` ## Коды ошибок | HTTP-статус | Код | Значение | | - | - | - | | 401 | `missing_api_key` / `invalid_api_key` | Отсутствует или некорректный API-ключ. | | 403 | `account_banned` | Аккаунт заблокирован. | | 403 | `ip_not_allowed` | Запрос пришёл с адреса вне IP-allowlist ключа. | | 429 | `rate_limit_exceeded` | Превышен поминутный лимит вашего ключа. Подождите время, указанное в заголовке `Retry-After`. | | 503 | `p2p_disabled` | P2P-маркет сейчас отключён. | ## OpenAPI ````yaml GET /p2p/inventory openapi: 3.1.0 info: title: CSBoard API version: 1.0.0 description: >- Market data over the CSBoard marketplace — live listings, floats, stickers, minAsk prices, FX rates — plus opt-in buying straight from your balance. Free to read, key-gated, built for automation. contact: name: CSBoard url: https://csboard.com/docs servers: - url: https://csboard.com/v1 description: Production security: - bearerAuth: [] tags: - name: Status description: Liveness and freshness probes. - name: Market data description: Read the live catalog, prices, and FX rates. - name: Trading description: Buy listings from your CSBoard balance. Opt-in, key-gated. - name: P2P description: >- List your own CS2 skins on the CSBoard P2P market. Free — any valid key, no balance requirement. - name: Account description: Your balance, settled funds, and trading status. - name: Webhooks description: Register an endpoint and receive signed order updates instead of polling. paths: /p2p/inventory: get: tags: - P2P summary: Your inventory, ready to list description: >- Every CS2 item we have seen in your Steam inventory, one row per copy, with whether it can be listed right now and why not. Free — any valid key, no balance requirement. If we hold no current read of your inventory this call starts one and answers `inventory_proof.status = pending`; call again after `retry_after_ms`. operationId: getP2PInventory responses: '200': description: Your items and the state of the inventory read. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/P2PInventoryItem' inventory_proof: $ref: '#/components/schemas/P2PInventoryProof' required: - data - inventory_proof example: data: - operational_asset_id: 5b0c1f7e-3d2a-4c8e-9a61-2f4d8b7e1c30 asset_revision: >- sha256:fd0e6de607b774aaaf4d9cdb7e014c003ba614b03f0460b01e8c94bce034bac5 asset_id: '38451927734' market_hash_name: AK-47 | Redline (Field-Tested) context_id: '2' listable: true reasons: [] listed: false listing_id: null listing_status: null snapshot_completed_at: '2026-10-02T11:58:03.000Z' - operational_asset_id: c81e2d44-9b07-4f1a-b3d5-6e2a90f4c7b8 asset_revision: >- sha256:a5b10a9006f6ebb68f8b9e81c85b5a6d1bf0f32737fc3f57a597dd01e66e0523 asset_id: '38451927990' market_hash_name: Glock-18 | Water Elemental (Minimal Wear) context_id: '16' listable: false reasons: - code: hold_not_ended message: The Steam trade hold has not ended yet. listed: false listing_id: null listing_status: null snapshot_completed_at: '2026-10-02T11:58:03.000Z' inventory_proof: status: ready completed_at: '2026-10-02T11:58:03.000Z' asset_count: 2 '401': $ref: '#/components/responses/Unauthorized' '403': description: Forbidden — the key's IP allowlist or an account ban. content: application/json: schema: $ref: '#/components/schemas/Error' examples: account_banned: summary: Account banned value: code: account_banned detail: This account is banned. ip_not_allowed: summary: Request from outside the key's IP allowlist value: code: ip_not_allowed detail: >- This API key is restricted to an IP allowlist and 203.0.113.7 is not on it. Update it at https://csboard.com/profile?tab=api '429': $ref: '#/components/responses/RateLimited' '503': $ref: '#/components/responses/P2PDisabled' components: schemas: P2PInventoryItem: type: object properties: operational_asset_id: type: string description: Send this to `POST /p2p/listings`. asset_revision: type: string description: Send this to `POST /p2p/listings` unchanged. asset_id: type: string description: Steam asset id — tells two copies of the same skin apart. market_hash_name: type: string context_id: type: string enum: - '2' - '16' description: Steam inventory context the copy was seen in. listable: type: boolean description: '`true` when this copy can be published right now.' reasons: type: array description: >- Why it cannot be published — empty when `listable` is `true`. Typical codes: `snapshot_stale`, `not_tradable`, `on_hold`, `hold_not_ended`, `already_listed`, `reserved`, `active_trade`. items: type: object properties: code: type: string message: type: string listed: type: boolean description: Already has a listing. listing_id: type: - string - 'null' listing_status: type: - string - 'null' description: Status of that listing, as in `P2PListing.status`. snapshot_completed_at: type: - string - 'null' format: date-time description: When the inventory read that last saw this copy finished. P2PInventoryProof: type: - object - 'null' description: >- Whether we hold a current read of your Steam inventory. Publishing needs `ready`. On `pending`, call `GET /p2p/inventory` again after `retry_after_ms`. On `blocked`, `code` says what to fix on your side. properties: status: type: string enum: - ready - pending - blocked completed_at: type: string format: date-time description: '`ready` only.' asset_count: type: - integer - 'null' description: '`ready` only.' started_at: type: string format: date-time description: '`pending` only.' retry_after_ms: type: integer description: '`pending` only — when to ask again.' code: type: string description: >- `blocked` only: `no_steam_link`, `no_trade_url`, `private_inventory`, `invalid_trade_url`, `empty_inventory`, `inventory_too_large`, `bot_service_unavailable` or `build_timed_out`. message: type: string description: '`blocked` only.' Error: type: object description: >- All errors return { code, detail }. Some carry extra fields (e.g. price_moved adds current_total_usd, insufficient_balance adds required_usd/current_usd). properties: code: type: string description: >- Machine-readable error code, e.g. rate_limit_exceeded, trading_not_enabled, price_moved. detail: type: string description: Human-readable explanation. required: - code responses: Unauthorized: description: Missing or invalid API key (`missing_api_key` or `invalid_api_key`). content: application/json: schema: $ref: '#/components/schemas/Error' example: code: missing_api_key detail: >- Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api RateLimited: description: >- Rate limit exceeded. Includes a Retry-After header (60 seconds on the per-key limits). headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limit_exceeded detail: Rate limit of 100 requests/min exceeded. P2PDisabled: description: The P2P market is switched off. content: application/json: schema: $ref: '#/components/schemas/Error' examples: p2p_disabled: summary: P2P market unavailable value: code: p2p_disabled detail: The P2P market is not available right now. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Send your key as a Bearer token on every request: `Authorization: Bearer csb_pub_...`. Generate keys in your CSBoard profile. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.