Get Billing Graph - Cerebrium

Get Billing Graph

curl --request GET \
  --url https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "labels": "<array>",
  "meta": {},
  "others": {},
  "series": "<array>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

GET

/

v2

/

projects

/

{project_id}

/

billing

/

graph

Get Billing Graph

curl --request GET \
  --url https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rest.cerebrium.ai/v2/projects/{project_id}/billing/graph")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "labels": "<array>",
  "meta": {},
  "others": {},
  "series": "<array>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Service Account Token authentication. To authenticate API requests:

Create a Service Account Token:
- Go to the Cerebrium Dashboard and open the API Keys page
- Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
- Copy the token generated for the desired service account
Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>
Best Practices:
- Create separate service accounts for different environments (dev, staging, prod)
- Store tokens securely as secrets in consuming applications or workflows
- Set appropriate expiry dates and rotate tokens regularly
- Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id

string

required

Query Parameters

month

string

Month to query in YYYY-MM format, or 'current'/'previous' aliases

granularity

string

Time granularity for data points (currently only 'day' is supported)

top_n

integer

Number of top apps to return (default 10)

group_others

boolean

Whether to group remaining apps into 'Others' (true/false)

include_app_ids

string

Comma-separated list of app IDs to include (optional filter)

exclude_app_ids

string

Comma-separated list of app IDs to exclude (optional filter)

Response

Daily per-app billing cost time series for the requested month, ready for charting.

labels

array

Date labels (YYYY-MM-DD) for each data point in the series, covering the requested month.

meta

object

Summary metadata. Contains window_start (string), window_end (string), currency (string), total_apps (integer), returned_apps (integer), top_n (integer), y_max_suggestion (number), total_cost_before_discounts (number), total_discounts (number), and total_cost_after_discounts (number).

others

object

Aggregated series for apps outside the top N when group_others is true. Contains count (integer of grouped apps), data (array of daily cost numbers aligned with labels), and total (number). Omitted otherwise.

series

array

Per-app cost series. Each item contains app_id (string), app_name (string), data (array of daily cost numbers aligned with labels), and total (number) for the month.