Sign in

v1

latestOpenAPI 3.1.02026-07-2676123203.9 KB
Billing

Get pod billing history

Returns pod-only billing detail for the authenticated user, split into time buckets by startTime/endTime with bucketSize or by lastN recent buckets. Use podId to narrow the response to one GPU or CPU pod; without it, records are emitted per pod per bucket. Each record includes podId, GPU, CPU, disk, and total amounts, while metadata echoes the resolved query and totals across the pod records. Use listBilling when you need aggregate spend across every billable resource family.

get/v2/billing/pods

Query parameters

startTimestring date-time

Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.

endTimestring date-time

End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.

bucketSize'hour' | 'day' | 'week' | 'month' | 'year'

Length of each billing time bucket.

Example:day

Length of each billing time bucket. Defaults to day.

lastNinteger

Return the last N buckets of bucketSize, ending with the current (in-progress) bucket — e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.

podIdstring

Filter to a specific pod (GPU or CPU).

Response

OK

Example response

{
  "records": [
    {
      "startTime": "2026-06-01T00:00:00Z",
      "endTime": "2026-06-02T00:00:00Z",
      "totalAmount": 12.34,
      "podId": "pod_abc123"
    }
  ],
  "metadata": {
    "query": {
      "startTime": "2026-06-01T00:00:00Z",
      "endTime": "2026-06-02T00:00:00Z",
      "bucketSize": "day"
    },
    "totals": {
      "totalAmount": 12.34
    }
  }
}