GET
/
billing
/
pods
curl --request GET \
  --url https://rest.runpod.io/v1/billing/pods \
  --header 'Authorization: Bearer <token>'
[
  {
    "amount": 100.5,
    "diskSpaceBilledGb": 50,
    "endpointId": "<string>",
    "gpuTypeId": "<string>",
    "podId": "<string>",
    "time": "2023-01-01T00:00:00Z",
    "timeBilledMs": 3600000
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
bucketSize
enum<string>
default:day

The length of each billing time bucket. The billing time bucket is the time range over which each billing record is aggregated.

Available options:
hour,
day,
week,
month,
year
​
endTime
string

The end date of the billing period to retrieve.

Example:

"2023-01-31T23:59:59Z"

​
gpuTypeId
enum<string>

Filter to Pods with the provided GPU type attached.

Available options:
NVIDIA GeForce RTX 4090,
NVIDIA A40,
NVIDIA RTX A5000,
NVIDIA GeForce RTX 3090,
NVIDIA RTX A4500,
NVIDIA RTX A6000,
NVIDIA L40S,
NVIDIA L4,
NVIDIA H100 80GB HBM3,
NVIDIA RTX 4000 Ada Generation,
NVIDIA A100 80GB PCIe,
NVIDIA A100-SXM4-80GB,
NVIDIA RTX A4000,
NVIDIA RTX 6000 Ada Generation,
NVIDIA RTX 2000 Ada Generation,
NVIDIA H200,
NVIDIA L40,
NVIDIA H100 NVL,
NVIDIA H100 PCIe,
NVIDIA GeForce RTX 3080 Ti,
NVIDIA GeForce RTX 3080,
NVIDIA GeForce RTX 3070,
Tesla V100-PCIE-16GB,
AMD Instinct MI300X OAM,
NVIDIA RTX A2000,
Tesla V100-FHHL-16GB,
NVIDIA GeForce RTX 4080 SUPER,
Tesla V100-SXM2-16GB,
NVIDIA GeForce RTX 4070 Ti,
Tesla V100-SXM2-32GB,
NVIDIA RTX 4000 SFF Ada Generation,
NVIDIA RTX 5000 Ada Generation,
NVIDIA GeForce RTX 5090,
NVIDIA A30,
NVIDIA GeForce RTX 4080,
NVIDIA GeForce RTX 5080,
NVIDIA GeForce RTX 3090 Ti,
NVIDIA B200
Example:

"NVIDIA GeForce RTX 4090"

​
grouping
enum<string>
default:gpuTypeId

Group the billing records by the provided field.

Available options:
podId,
gpuTypeId
​
podId
string

Filter to a specific Pod.

Example:

"xedezhzb9la3ye"

​
startTime
string

The start date of the billing period to retrieve.

Example:

"2023-01-01T00:00:00Z"

Response

200 - application/json

Successful operation.

The response is of type object[].