---
title: "Usage: расход ключа, всех ключей API и аккаунта"
method: GET
path: "/usage"
tags: ["Account"]
---

# Usage: расход ключа, всех ключей API и аккаунта

`GET /usage`

## Request

- Base URL: `https://vibemarketolog.ru/api/agent`
- URL: `https://vibemarketolog.ru/api/agent/usage`
- Auth: HTTP bearer

Блоки key (этот ключ), api (все ключи аккаунта) и account (весь аккаунт: services — работа, purchases — покупки тарифов и серверов, bonus_expired — сгоревшие бонусы, manual_debits — ручные списания) считаются по журналу операций ключей: возвраты вычтены, сутки по Москве. Поля total_spent / total_requests / by_day сохранены для совместимости и устарели: они складывают все списания аккаунта, включая сгорание бонусов, без вычета возвратов, в сутках UTC.

## Query parameters

- `period` 'today' | 'week' | 'month'
- `days` 0 | 1 | 7 | 30 | 90

## Response `200`

Usage

- object
  - `period` string
  - `days` integer
  - `total_spent` number
  - `total_requests` integer
  - `by_day` object[]
  - `key` object
    - `spent` number: Итог: списано минус вернулось, ₽
    - `charged` number: Списано, ₽
    - `refunded` number: Вернулось, ₽
    - `bonus` number: Из итога оплачено бонусами, ₽
    - `operations` integer: Число платных операций
    - `key_id` integer
    - `name` string
    - `by_day` object[]
      - `date` string, date
      - `spent` number
      - `operations` integer
    - `by_category` object[]
      - `category` string
      - `label` string
      - `spent` number
      - `operations` integer
      - `share` number
    - `by_model` object[]
      - `model` string
      - `spent` number
      - `operations` integer
  - `api` object
    - `spent` number: Итог: списано минус вернулось, ₽
    - `charged` number: Списано, ₽
    - `refunded` number: Вернулось, ₽
    - `bonus` number: Из итога оплачено бонусами, ₽
    - `operations` integer: Число платных операций
    - `by_key` object[]
      - `key_id` integer, nullable
      - `name` string
      - `prefix` string, nullable
      - `kind` string, nullable
      - `spent` number
      - `operations` integer
  - `account` object
    - `spent` number: ₽, после вычета возвратов
    - `services` number: ₽, после вычета возвратов
    - `purchases` number: ₽, после вычета возвратов
    - `bonus_expired` number: Сгоревшие бонусы — не трата
    - `manual_debits` number
  - `range` object
    - `from` string, date-time
    - `to` string, date-time
    - `tz` string
  - `history_from` string, date, nullable: С какой даты есть история операций по ключам

## Other responses

- `401`: Ключ не передан, недействителен, отозван или истёк (missing_token / invalid_token)
- `403`: У ключа нет нужного права либо адрес запроса не в списке разрешённых (insufficient_scope / ip_not_allowed)
- `429`: Превышена частота запросов или суточный лимит траты ключа (rate_limit_exceeded / daily_spend_limit_exceeded)
- `500`: Внутренняя ошибка сервиса; повторите позже и сообщите request_id (internal_error)

---

[API](https://skmtc.dev/vibemarketolog/apis/agent-api.md) · [All operations](https://skmtc.dev/vibemarketolog/apis/agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vibemarketolog/apis/agent-api/revisions/6a74f8ad5d58?raw)