---
title: "Передплачений баланс і підсумок тарифікації за період"
method: GET
path: "/v1/billing/usage"
tags: ["billing"]
---

# Передплачений баланс і підсумок тарифікації за період

`GET /v1/billing/usage`

## Request

- Base URL: `https://prro.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://prro.cloud/v1/billing/usage`
- Auth: HTTP bearer

Суми — копійки десятковим рядком. Типовий період — поточний календарний місяць за UTC, межа `to` не включається; період понад 366 днів — 422. Тарифікація асинхронна, тож підсумок може відставати від останнього чека на кілька секунд.

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

Баланс і використання за період.

- BillingUsage: Баланс і підсумок тарифікації за період.
  - `balance` string, required: Копійки десятковим рядком (numeric(14,4)); ніколи не число з рухомою комою.
  - `soft_limit` string, required: Копійки десятковим рядком (numeric(14,4)); ніколи не число з рухомою комою.
  - `blocked` boolean, required: Чеки зараз заблоковано — балансом або рішенням оператора.
  - `period` object, required: Період, за який пораховано підсумок.
    - `from` string, date, required: Включно.
    - `to` string, date, required: Не включно.
  - `receipts` integer, required: Кількість тарифікованих чеків за період.
  - `charged` string, required: Копійки десятковим рядком (numeric(14,4)); ніколи не число з рухомою комою.
  - `tariff` object, required: Тариф, за яким рахували.
    - `plan_id` string, uuid, required: Ідентифікатор тарифного плану.
    - `price_per_receipt` string, required: Копійки десятковим рядком (numeric(14,4)); ніколи не число з рухомою комою.

## Other responses

- `401`: Немає облікових даних, або вони недійсні, протерміновані чи відкликані.
- `422`: Конверт помилки.

---

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