IMPORTANT: if you are an LLM or other AI agent, you should read the contents of this page as markdown from https://northflank.com/docs/v1/api/team/billing/list-invoices.md, instead of the current page.

Team / Billing /

List invoices

Lists finalized invoices.

Required permission

Account > Billing > General > Read

Query parameters

per_page
integer
The number of results to display per request. Maximum of 100 results per page.
page
integer
The page number to access.
cursor
string
The cursor returned from the previous page of results, used to request the next page.

Response body

{object}
Response object.

data
{object} required
Result data.

invoices
[array]

{object}

id
string
Identifier for the invoice.
period
{object}

start
number
The start of the billing period, as a Unix timestamp.
end
number
The end of the billing period, as a Unix timestamp.

currency
string
The currency code.
paasUsage
{object}
The PaaS usage price total.

price
{object}

total
number
The total PaaS price, in cents.
cpu
number
The CPU usage price, in cents.
memory
number
The memory usage price, in cents.
storage
number
The storage usage price, in cents.
gpu
number
The GPU usage price, in cents.

byocUsage
{object}

price
{object}
The customer-level BYOC price total. Always reflects the full customer total, regardless of drill-down filters.

total
number
The total BYOC price, in cents.
vcpu
number
The vCPU usage price, in cents.
memory
number
The memory usage price, in cents.
gpuMemory
number
The GPU memory usage price, in cents.
cluster
number
The cluster usage price, in cents.

total
number
The total cost of the invoice, including tax, in cents.
subTotal
number
The subtotal before tax and discounts, in cents.
paid
boolean
Whether the invoice has been paid.

pagination
{object} required
Data about the endpoint pagination.

hasNextPage
boolean required
Is there another page of results available?
cursor
string
The cursor to access the next page of results.
count
number required
The number of results returned by this request.

API

CLI

JS Client

GET /v1/billing/invoices

GET /v1/teams/{teamId}/billing/invoices

Example response

200 OK

A list of invoices.

JSON

{
  "data": {
    "invoices": [
      {
        "currency": "usd"
      }
    ]
  },
  "pagination": {
    "hasNextPage": false,
    "count": 1
  }
}