Skip to content

CostItemPage

A page of cost items, newest first.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

A cost of the instance that is not deleted, with its current label and end and every price revision. Never published: the public totals carry no item.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
schedule
required

The unit of a cost item’s payment schedule: once (one payment on the start date), or every interval weeks, months, or years, counted from the start date. A monthly payment on a day that a month does not have falls on the month’s last day.

string
Allowed values: once weeks months years
interval
required

The N of every N weeks, months, or years; 1 for once.

integer
>= 1 <= 99
starts_on
required

A calendar date YYYY-MM-DD without a time or a time zone, such as the day of a payment on a card statement or an invoice.

string
/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/
ends_on

A calendar date YYYY-MM-DD without a time or a time zone, such as the day of a payment on a card statement or an invoice.

string
/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/
name
required
string
provider
required

Who is paid, as written; the breakdown groups it in NFKC and lower case.

string
category
required

The fixed category of a cost; clients translate its name.

string
Allowed values: compute database storage network domain email software other
memo
required

The operator’s note, never published; empty for none.

string
prices
required

Every price revision, in the order they were recorded; the first one starts on starts_on. ends_on is the last date a payment can fall on (included), omitted for no end; starts_on is the first payment date, the payment date of once.

Array<object>

A price of a cost item for its payments on or after effective_on, until a later revision; of revisions with the same date, the last recorded wins.

object
effective_on
required

A calendar date YYYY-MM-DD without a time or a time zone, such as the day of a payment on a card statement or an invoice.

string
/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/
price
required

Schema: Money

object
revised_at
required
string format: date-time
created_at
required
string format: date-time

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"schedule": "once",
"interval": 1,
"starts_on": "example",
"ends_on": "example",
"name": "example",
"provider": "example",
"category": "compute",
"memo": "example",
"prices": [
{
"effective_on": "example",
"price": {},
"revised_at": "2026-04-15T12:00:00Z"
}
],
"created_at": "2026-04-15T12:00:00Z"
}
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site