GET
/
billing
/
endpoints
curl --request GET \
  --url https://rest.runpod.io/v1/billing/endpoints \
  --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
​
dataCenterId
enum<string>[]

Filter to endpoints located in any of the provided RunPod data centers. The data center IDs are listed in the response of the /pods endpoint.

Example:
["EU-RO-1", "CA-MTL-1"]
​
endpointId
string

Filter to a specific endpoint.

Example:

"jpnw0v75y3qoql"

​
endTime
string

The end date of the billing period to retrieve.

Example:

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

​
gpuTypeId
enum<string>[]

Filter to endpoints with the provided GPU type attached.

Example:

"NVIDIA GeForce RTX 4090"

​
grouping
enum<string>
default:endpointId

Group the billing records by the provided field.

Available options:
endpointId,
podId,
gpuTypeId
​
imageName
string

Filter to endpoints created with the provided image.

Example:

"runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04"

​
startTime
string

The start date of the billing period to retrieve.

Example:

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

​
templateId
string

Filter to endpoints created from the provided template.

Example:

"30zmvf89kd"

Response

200 - application/json

Successful operation.

The response is of type object[].