GET
/
billing
/
endpoints
Serverless billing history
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<date-time>

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<date-time>

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.

​
amount
number

The amount charged for the group for the billing period, in USD.

Example:

100.5

​
diskSpaceBilledGb
integer

The amount of disk space billed for the billing period, in gigabytes (GB). Does not apply to all resource types.

Example:

50

​
endpointId
string

If grouping by endpoint ID, the endpoint ID of the group.

​
gpuTypeId
string

If grouping by GPU type ID, the GPU type ID of the group.

​
podId
string

If grouping by Pod ID, the Pod ID of the group.

​
time
string<date-time>

The start of the period for which the billing record applies.

Example:

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

​
timeBilledMs
integer

The total time billed for the billing period, in milliseconds. Does not apply to all resource types.

Example:

3600000