---
title: "История списаний кредитов · бесплатно"
method: GET
path: "/v1/account/usage"
tags: ["Аккаунт"]
---

# История списаний кредитов · бесплатно

`GET /v1/account/usage`

## Request

- Base URL: `https://maxstat.ru/api`
- URL: `https://maxstat.ru/api/v1/account/usage`
- Auth: API key in header `X-API-Token`

> 💳 **Стоимость:** бесплатно

Возвращает пагинированную историю списаний кредитов по вашему аккаунту, отсортированную от новых к старым. Поле `request_id` каждой записи совпадает со значением заголовка `X-Request-Id` соответствующего запроса.

## Query parameters

- `limit` integer: Максимальное количество записей в ответе.
- `offset` integer: Количество записей, которое нужно пропустить от начала списка.

## Response `200`

Successful Response

- AccountUsageResponse
  - `items` AccountUsageEvent[], required: Список списаний кредитов, отсортированный от новых к старым.
    - `request_id` string, uuid, required: Идентификатор запроса, за который были списаны кредиты. Совпадает со значением заголовка `X-Request-Id` в ответе на этот запрос.
    - `operation_code` string, required: Код операции API.
    - `credits_charged` integer, required: Количество списанных кредитов.
    - `method` string, required: HTTP-метод запроса.
    - `path` string, required: Путь запроса.
    - `created_at` string, date-time, required: Дата и время списания.

## Other responses

- `401`: Ошибка аутентификации: API-токен не передан, недействителен или отозван.
- `402`: Проблема с тарифом: нет активного периода подписки или недостаточно кредитов.
- `403`: Доступ запрещён.
- `422`: Ошибка валидации параметров запроса. Подробности — в поле details.
- `429`: Превышен лимит запросов. Повторите запрос позже.
- `500`: Внутренняя ошибка сервиса. Сообщите request_id в поддержку.
- `503`: Сервис временно перегружен. Повторите запрос через несколько секунд (см. заголовок Retry-After).

---

[API](https://skmtc.dev/maxstat/apis/maxstat-public-api.md) · [All operations](https://skmtc.dev/maxstat/apis/maxstat-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maxstat/apis/maxstat-public-api/revisions/4eff97f9a0b2?raw)