Get billing summary information for an account

curl --request GET \
  --url https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary"

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

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

print(response.text)

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

fetch('https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary', 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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary",
  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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary"

	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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary")

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

{
  "lineItems": [
    {
      "category": "<string>",
      "groupingKey": "<string>",
      "groupingValue": "<string>",
      "secondaryGroupingKey": "<string>",
      "secondaryGroupingValue": "<string>",
      "quantity": 123,
      "unitAmount": {
        "currencyCode": "<string>",
        "units": "<string>",
        "nanos": 123
      },
      "totalCost": {
        "currencyCode": "<string>",
        "units": "<string>",
        "nanos": 123
      },
      "series": "USAGE_TYPE_UNSPECIFIED"
    }
  ],
  "usageBuckets": [
    {
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "lineItems": [
        {
          "category": "<string>",
          "groupingKey": "<string>",
          "groupingValue": "<string>",
          "secondaryGroupingKey": "<string>",
          "secondaryGroupingValue": "<string>",
          "quantity": 123,
          "unitAmount": {
            "currencyCode": "<string>",
            "units": "<string>",
            "nanos": 123
          },
          "totalCost": {
            "currencyCode": "<string>",
            "units": "<string>",
            "nanos": 123
          },
          "series": "USAGE_TYPE_UNSPECIFIED"
        }
      ]
    }
  ]
}

GET

accounts

{account_id}

billing

summary

Get billing summary information for an account

curl --request GET \
  --url https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary"

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

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

print(response.text)

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

fetch('https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary', 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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary",
  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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary"

	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://api.fireworks.ai/v1/accounts/{account_id}/billing/summary")

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

{
  "lineItems": [
    {
      "category": "<string>",
      "groupingKey": "<string>",
      "groupingValue": "<string>",
      "secondaryGroupingKey": "<string>",
      "secondaryGroupingValue": "<string>",
      "quantity": 123,
      "unitAmount": {
        "currencyCode": "<string>",
        "units": "<string>",
        "nanos": 123
      },
      "totalCost": {
        "currencyCode": "<string>",
        "units": "<string>",
        "nanos": 123
      },
      "series": "USAGE_TYPE_UNSPECIFIED"
    }
  ],
  "usageBuckets": [
    {
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "lineItems": [
        {
          "category": "<string>",
          "groupingKey": "<string>",
          "groupingValue": "<string>",
          "secondaryGroupingKey": "<string>",
          "secondaryGroupingValue": "<string>",
          "quantity": 123,
          "unitAmount": {
            "currencyCode": "<string>",
            "units": "<string>",
            "nanos": 123
          },
          "totalCost": {
            "currencyCode": "<string>",
            "units": "<string>",
            "nanos": 123
          },
          "series": "USAGE_TYPE_UNSPECIFIED"
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication using your Fireworks API key. Format: Bearer <API_KEY>

Path Parameters

account_id

string

required

The Account Id

Query Parameters

startTime

string<date-time>

required

Start time for the billing period. Note: Costs are aggregated daily. Only the date portion (YYYY-MM-DD) is used; the time portion is ignored. For example, 2025-10-05T07:18:29Z and 2025-10-05T23:59:59Z are treated the same as 2025-10-05T00:00:00Z.

endTime

string<date-time>

required

End time for the billing period (exclusive). Note: Costs are aggregated daily. Only the date portion (YYYY-MM-DD) is used; the time portion is ignored. Costs for the end date are NOT included. For example, to get costs for Oct 5 and Oct 6, use: start_time: 2025-10-05T00:00:00Z end_time: 2025-10-07T00:00:00Z (Oct 7 is excluded)

granularity

enum<string>

default:GRANULARITY_UNSPECIFIED

Requested breakdown granularity. Defaults to UNSPECIFIED (no breakdown).

Available options:

GRANULARITY_UNSPECIFIED,

DAILY

Response

200 - application/json

A successful response.

lineItems

Individual billing line item · object[]

Show child attributes

usageBuckets

object[]

Per-bucket breakdown, populated only when the request sets a non-UNSPECIFIED granularity. One bucket per period at that granularity.

Show child attributes

API Reference

Inference

Deployments

Training

Training SDK

Evals

Admin

Get billing summary information for an account

Authorizations

Path Parameters

Query Parameters

Response