---
title: "Рахунки клієнта, від найновішого періоду"
method: GET
path: "/v1/invoices"
tags: ["billing"]
---

# Рахунки клієнта, від найновішого періоду

`GET /v1/invoices`

## Request

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

Один рядок на розрахунковий період, а не на окремий платіж.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Рахунки клієнта.

- object
  - `invoices` Invoice[], required: Рахунки, від найновішого періоду.
    - `id` string, uuid, required: Ідентифікатор рахунка.
    - `period_start` string, date, required: Включно.
    - `period_end` string, date, required: Включно.
    - `amount` string, required: Копійки десятковим рядком (numeric(14,4)); ніколи не число з рухомою комою.
    - `currency` string, required: Валюта рахунка за ISO 4217 — UAH.
    - `status` 'draft' | 'issued' | 'paid' | 'overdue', required: draft — чернетка; issued — виставлено; paid — оплачено; overdue — прострочено.
    - `created_at` string, date-time, required: Коли рахунок сформовано.

## 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)