Account

Invoices List

get
https://api.linode.com/v4/account/invoices

Returns a paginated list of Invoices against your Account.

Query Parameters

page
integer > = 1
Default: 1

The page of a collection to return.

page_size
integer [25 .. 500]
Default: 100

The number of items to return per page.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/account/invoices

Response Samples

{
  "data": [
    {
      "id": "",
      "date": "2018-01-01T00:01:01",
      "label": "Invoice",
      "subtotal": 120.25,
      "tax": 12.25,
      "tax_summary": [],
      "total": 132.5
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: Returns a paginated list of Invoice objects.

data
array of objects
id
integer

The Invoice's unique ID.

date
string

When this Invoice was generated.

label
string

The Invoice's display label.

subtotal
number

The amount of the Invoice before taxes in US Dollars.

tax
number

The amount of tax levied on the Invoice in US Dollars.

tax_summary
array

The amount of tax broken down into subtotals by source.

total
number

The amount of the Invoice after taxes in US Dollars.

page
integer

The current page.

pages
integer

The total number of pages.

results
integer

The total number of results.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.