GET
Get metered usage

Authorizations

Authorization
string
header
required

Developer session token from POST /v1/auth/login or POST /v1/auth/register. Valid 7 days.

Authenticates the developer control plane. It also reaches the server and build endpoints, which a dashboard has to drive and which no session can otherwise call: an API key's value is returned once, at mint, so nothing can read back a key for an existing project. On those endpoints a session names its project with project_id, or is resolved from the resource it addresses, and is always checked against the account that owns it.

It reaches no player-facing game endpoint.

Query Parameters

month
string

Billing month to report, as YYYY-MM. Defaults to the current period.

Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])$
Example:

"2026-08"

Response

Usage for the period.

Metered usage for one billing period, broken down by project. Costs are USD. The current period is live and moves as servers run.

period
string
required

Billing period in YYYY-MM.

Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])$
Example:

"2026-09"

total_cost
number
required
Example:

24.5

credit_applied
number
required

Plan credit applied to this period. Pro accounts carry $5/mo of server credit; it does not roll over.

Example:

5

balance_due
number
required

total_cost minus credit_applied, floored at zero.

Example:

19.5

projects
object[]
required