# Активность по дням

Source: https://provod.ai/ru/docs/activity

**`GET /v1/activity`**

Получите активность по моделям за последние 30 завершённых дней UTC. Сегодняшний день не включается.

## Авторизация

`Authorization: Bearer <MANAGEMENT_API_KEY>`: управляющий ключ выбранного рабочего пространства.

Рабочее пространство определяется ключом. Заголовок `X-Org-Id` не поддерживается.

## Query-параметры


| Поле                                                 | Тип    | Описание                                                                                      |
| ---------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------- |
| `date`                                               | string | YYYY-MM-DD; необязательный день внутри окна. Дата за пределами окна возвращает пустой список. |
| `group_by`                                           | string | workspace; добавляет workspace\_id в ответ.                                                   |
| `workspace_id, api_key_hash, user_id, external_user` | string | 1–128 символов. Необязательные фильтры, не расширяют доступ.                                  |


## Ответ · 200


| Поле                                                                       | Тип       | Описание                                                |
| -------------------------------------------------------------------------- | --------- | ------------------------------------------------------- |
| `data`                                                                     | object\[] | Строка для каждой даты UTC и модели.                    |
| `data[].date`                                                              | string    | YYYY-MM-DD.                                             |
| `data[].model, data[].model_permaslug`                                     | string    | Публичный ID модели; одинаковое значение в обоих полях. |
| `data[].requests`                                                          | number    | Количество завершённых запросов.                        |
| `data[].prompt_tokens, completion_tokens, reasoning_tokens, cached_tokens` | number    | Зафиксированные счётчики токенов строки.                |
| `data[].usage`                                                             | number    | Фактические расходы в currency.                         |
| `data[].usage_exact`                                                       | string    | Та же сумма с 8 знаками после запятой.                  |
| `data[].currency`                                                          | string    | Валюта рабочего пространства.                           |
| `data[].workspace_id`                                                      | string    | Только при group\_by=workspace.                         |
| `data[].provider_name, data[].endpoint_id`                                 | string    | Сейчас unknown.                                         |
| `data[].byok_usage_inference`                                              | number    | Всегда 0.                                               |


Расходы группируются по времени проводки, статистика запросов по времени завершения. Платные ошибки и разрывы соединения входят в расходы. Возвраты не уменьшают исходное списание. Для сверки используйте точные строки и десятичную арифметику.

### Пример ответа

Все идентификаторы и суммы в примерах условные.


**JSON ответа**


```json
{
  "data": [
    {
      "date": "2026-11-09",
      "model": "example/model",
      "model_permaslug": "example/model",
      "requests": 1,
      "prompt_tokens": 10,
      "completion_tokens": 5,
      "reasoning_tokens": 0,
      "cached_tokens": 0,
      "usage": 0.0125,
      "usage_exact": "0.01250000",
      "currency": "RUB",
      "workspace_id": "workspace_example",
      "provider_name": "unknown",
      "endpoint_id": "unknown",
      "byok_usage_inference": 0
    }
  ]
}
```



## Пример запроса

Загрузите ключ в переменную окружения на сервере. TypeScript использует встроенный fetch в Node.js, Python только стандартную библиотеку.




TypeScript



Python



cURL




```typescript
const response = await fetch("https://api.provod.ai/v1/activity?group_by=workspace", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MANAGEMENT_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
```



```python
import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://api.provod.ai/v1/activity?group_by=workspace",
    method="GET",
    headers={"Authorization": f"Bearer {os.environ['MANAGEMENT_API_KEY']}"},
)
with urlopen(request) as response:
    print(json.load(response))
```



```bash
curl --fail-with-body --silent --show-error -X GET \
  "https://api.provod.ai/v1/activity?group_by=workspace" \
  -H "Authorization: Bearer ${MANAGEMENT_API_KEY}"
```



## Ошибки


| HTTP  | Ошибка            | Причина                                                                                                             |
| ----- | ----------------- | ------------------------------------------------------------------------------------------------------------------- |
| `401` | Unauthorized      | Отсутствующий, недействительный, отключённый, отозванный или истёкший ключ. Заголовок `X-Org-Id` также отклоняется. |
| `403` | Forbidden         | Неверный тип ключа или недостаточно прав в рабочем пространстве.                                                    |
| `400` | Bad Request       | Неверные или неизвестные параметры.                                                                                 |
| `429` | Too Many Requests | Превышен лимит запросов аналитики: 2 в секунду, 30 в минуту; также действуют общие ограничения сервиса.             |


\| `503` | Service Unavailable | Сервис ограничения частоты запросов временно недоступен. Повторите позже. |

Пример ошибки авторизации:

```json
{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key",
    "metadata": {}
  }
}
```

Пример ошибки метода:

```json
{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}
```

## Далее

* [Управляющие ключи](/ru/docs/management-keys)
* [Стоимость запроса](/ru/docs/generation-metadata)

При `429` учитывайте заголовок `Retry-After`. Лимит применяется к рабочему пространству для каждого метода.
