Get the billing account
GET/v1/billing/account
- Scopes
billing:read
the tenant's billing plan (current effective version and prices) and availability of payment through the provider. No plan - configured=false; prices are never shown as a fact without a tariff.
Responses
200BillingAccountView400401403404409412413415422428429503
List invoices
GET/v1/billing/invoices
- Scopes
billing:read
Parameters
| Field | Type | Required |
|---|
cursorquery | string | no |
|---|
limitquery | integer | no |
|---|
statusquery | enum: issued, partially_paid, paid, overdue, cancelled | no |
|---|
Responses
200InvoiceList400401403404409412413415422428429503
Get an invoice
GET/v1/billing/invoices/{invoice_id}
- Scopes
billing:read
Parameters
| Field | Type | Required |
|---|
invoice_idpath | string (uuid) | yes |
|---|
Responses
200Invoice400401403404409412413415422428429503
Download an invoice
POST/v1/billing/invoices/{invoice_id}/document
- Scopes
billing:read- Required header
Idempotency-Key
signed short-lived URL of the invoice PDF (same generator as reports). 409 bad_state while the document is being generated.
Parameters
| Field | Type | Required |
|---|
invoice_idpath | string (uuid) | yes |
|---|
Responses
200Download400401403404409412413415422428429503
Pay an invoice
POST/v1/billing/invoices/{invoice_id}/payments
- Scopes
billing:pay
starts or resumes the online payment of the amount due through the payment provider (NerezPay). One active online payment per invoice: a repeated call returns the active payment and its URL. Disabled online payment - 503 capability_disabled with the reason.
Parameters
| Field | Type | Required |
|---|
invoice_idpath | string (uuid) | yes |
|---|
Responses
201InvoicePaymentStart400401403404409412413415422428429503