v1
latestOpenAPI 3.1.02026-07-2676123203.9 KBGet aggregated billing history
Returns time-bucketed total spend across all billable Runpod resources for the authenticated user. Use startTime/endTime with bucketSize for an explicit range, or lastN with bucketSize for the most recent buckets. Each record reports one bucket's total plus pod, serverless, storage, public endpoint, and Instant Cluster cost components. The metadata block echoes the resolved query window, record count, and totals across all returned buckets.
Query parameters
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.
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.
Length of each billing time bucket.
Length of each billing time bucket. Defaults to day.
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.
Response
OK
Example response
{
"records": [
{
"startTime": "2026-06-01T00:00:00Z",
"endTime": "2026-06-02T00:00:00Z",
"totalAmount": 42.34
}
],
"metadata": {
"query": {
"startTime": "2026-06-01T00:00:00Z",
"endTime": "2026-06-02T00:00:00Z",
"bucketSize": "day"
},
"totals": {
"totalAmount": 42.34
}
}
}