---
title: "История транзакций"
method: GET
path: "/v1/transactions"
tags: ["Management"]
---

# История транзакций

`GET /v1/transactions`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/transactions`
- Auth: HTTP bearer

Пополнения, списания, возвраты и бонусные операции аккаунта, свежие сверху. Требует management-ключ (sk-gw-mgmt-...).

## Query parameters

- `offset` integer, nullable
- `limit` integer
- `type` 'topup' | 'usage' | 'refund' | 'adjustment' | 'mcp_debit' | 'mcp_refund' | 'referral_bonus' | 'bonus_accrual' | 'bonus_spend' | 'bonus_expire' | 'bonus' | 'video_precharge' | 'video_reconcile'
- `from` string, date-time: Начало периода, ISO 8601.
- `to` string, date-time: Конец периода, ISO 8601.

## Response `200`

Страница транзакций.

- object
  - `object` 'list', required
  - `data` object[], required
    - `id` string, uuid, required
    - `type` 'topup' | 'usage' | 'refund' | 'adjustment' | 'mcp_debit' | 'mcp_refund' | 'referral_bonus' | 'bonus_accrual' | 'bonus_spend' | 'bonus_expire' | 'bonus' | 'video_precharge' | 'video_reconcile', required
    - `status` 'pending' | 'succeeded' | 'failed' | 'cancelled', required
    - `amount_kopecks` integer, required: Сумма операции в копейках: положительная — зачисление, отрицательная — списание.
    - `balance_after_kopecks` integer, required
    - `payment_method` 'sbp' | 'card' | 'invoice', nullable, required: Способ пополнения; null для не-topup операций.
    - `created_at` string, required
  - `has_more` boolean, required

## Other responses

- `400`: Невалидные параметры.
- `401`: Невалидный ключ.
- `403`: Нужен management-ключ.
- `429`: Превышен rate limit (60/мин).

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)