Skip to main content
GET
Usage and cost

Authorizations

X-API-Key
string
header
required

An Anona Compute API key (ac_ followed by lowercase hex; older keys start with e2b_).

Query Parameters

period
string
default:current
Pattern: ^(current|\d{4}-\d{2})$
limit
integer
default:50

Sandboxes per page.

Required range: 1 <= x <= 1000
cursor
string

The nextCursor of the previous page, for the same period. Opaque; a cursor from another period is a 400.

sandboxId
string

Return only this sandbox's row (an empty sandboxes if it had no usage in the period) instead of a page. Cannot be combined with cursor.

Maximum string length: 128

Response

The usage document.

tenant
object
required
period
object
required
availablePeriods
string[]
required
meters
object[]
required
totals
object
required
daily
object[]
required
sandboxes
object[]
required

One page of the period's sandboxes, most expensive first (see limit, cursor and sandboxId).

sandboxCount
integer
required

Sandboxes with usage in the period, whatever the page.

templates
object[]
required

Every template used in the period, most expensive first.

included
object

The month against what the plan includes, on the allocated rate card (absent for months before the current plans). vCPU-hours each include 2 GiB-hours of memory; storage is never included. On this rate card totals.dueUsd is overageUsd for a plan that bills it and 0 for Free, which stops instead.

nextCursor
string

Pass as cursor for the next page. Absent on the last page and for a sandboxId lookup.

lifecycle
object