List Instance Charges
Returns paginated instance charge details for the authenticated user within a required day range, optionally formatted as a hierarchical tree.
Authorizations
API key must be provided in the Authorization header
Query Parameters
day (required). Date range in unix seconds (UTC). Operators: gte, lte.
type (optional). Filter by contract type: instance, volume, serverless. Operator: in.
Examples:
table(default) flat list of per-contract rows withtype: "instance"or"volume".treeserverless contracts are collapsed under endpoint/workergroup wrappers withtype: "serverless"andsource: "endpoint-<id>"/"workergroup-<id>". Regular instances and volumes are unchanged.
table, tree "table"
Sort by most recent charges first.
true
Max results per page. Server maximum 500.
x >= 120
Pass the next_token value from the previous response to fetch the next page of results. When the response returns next_token: null, there are no more pages.
"eyJ2YWx1ZXMiOiB7ImlkIjogMTIzNDU2Nzh9fQ=="
Response
Host users: {"success": false, "msg": "Host users do not have instance charges", "count": 0, ...}
True on success
Number of unique instances/volumes in the result
Total matching instances/volumes across all pages
Charge entries with start, end, type, source, description, amount, metadata, and items fields
Cursor for the next page, or null