Export costs as FOCUS 1.2 rows

curl --request GET \
  --url https://api.brimble.io/core/v1/billing/focus \
  --header 'x-brimble-key: <api-key>'

const options = {method: 'GET', headers: {'x-brimble-key': '<api-key>'}};

fetch('https://api.brimble.io/core/v1/billing/focus', 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.brimble.io/core/v1/billing/focus",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-brimble-key: <api-key>"
  ],
]);

$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.brimble.io/core/v1/billing/focus"

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

	req.Header.Add("x-brimble-key", "<api-key>")

	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.brimble.io/core/v1/billing/focus")

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

request = Net::HTTP::Get.new(url)
request["x-brimble-key"] = '<api-key>'

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

{
  "message": "<string>",
  "data": {
    "focus_version": "1.2",
    "charge_period_start": "2023-11-07T05:31:56Z",
    "charge_period_end": "2023-11-07T05:31:56Z",
    "complete": true,
    "rows": [
      {
        "BillingAccountId": "cus_123",
        "BillingCurrency": "USD",
        "BillingPeriodStart": "2026-10-05T09:52:00+00:00",
        "BillingPeriodEnd": "2026-11-05T09:52:00+00:00",
        "ChargePeriodStart": "2026-10-06T00:00:00+00:00",
        "ChargePeriodEnd": "2026-10-07T00:00:00+00:00",
        "ChargeCategory": "Usage",
        "ChargeDescription": "CPU · api",
        "Provider": "brimble",
        "ServiceName": "Compute",
        "ServiceCategory": "Compute",
        "ResourceId": "6a4a4fce5fed1a67d9108e73",
        "ResourceName": "api",
        "ResourceType": "Project",
        "RegionId": "eu-central",
        "BilledCost": "0.033462",
        "EffectiveCost": "0.033462",
        "ListCost": "0.033300",
        "ConsumedQuantity": "0.0333",
        "ConsumedUnit": "vCPU-months"
      }
    ]
  }
}

{
  "errors": [
    {
      "type": "field",
      "value": "<unknown>",
      "msg": "Invalid value",
      "path": "name",
      "location": "body"
    }
  ]
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

Billing

Export costs as FOCUS 1.2 rows

Returns the account’s costs as FOCUS 1.2 rows, one per resource, meter and day, plus one row per plan fee, add-on, tax, discount and credit.

Rows for a finalized invoice add up to that invoice. The billing cycle that has not been invoiced yet is estimated: those rows carry x_Estimated: "true" and the response has complete: false. Request the same window again after the invoice is finalized to get the final rows.

A row belongs to the window that contains its ChargePeriodStart, so consecutive windows never repeat or drop a row.

An API key reads the account it was issued for. A signed-in user reads their own account, or a team with teamId.

API key scope: billing.read

Team role permission: billing.manage

GET

billing

focus

Export costs as FOCUS 1.2 rows

curl --request GET \
  --url https://api.brimble.io/core/v1/billing/focus \
  --header 'x-brimble-key: <api-key>'

const options = {method: 'GET', headers: {'x-brimble-key': '<api-key>'}};

fetch('https://api.brimble.io/core/v1/billing/focus', 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.brimble.io/core/v1/billing/focus",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-brimble-key: <api-key>"
  ],
]);

$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.brimble.io/core/v1/billing/focus"

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

	req.Header.Add("x-brimble-key", "<api-key>")

	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.brimble.io/core/v1/billing/focus")

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

request = Net::HTTP::Get.new(url)
request["x-brimble-key"] = '<api-key>'

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

{
  "message": "<string>",
  "data": {
    "focus_version": "1.2",
    "charge_period_start": "2023-11-07T05:31:56Z",
    "charge_period_end": "2023-11-07T05:31:56Z",
    "complete": true,
    "rows": [
      {
        "BillingAccountId": "cus_123",
        "BillingCurrency": "USD",
        "BillingPeriodStart": "2026-10-05T09:52:00+00:00",
        "BillingPeriodEnd": "2026-11-05T09:52:00+00:00",
        "ChargePeriodStart": "2026-10-06T00:00:00+00:00",
        "ChargePeriodEnd": "2026-10-07T00:00:00+00:00",
        "ChargeCategory": "Usage",
        "ChargeDescription": "CPU · api",
        "Provider": "brimble",
        "ServiceName": "Compute",
        "ServiceCategory": "Compute",
        "ResourceId": "6a4a4fce5fed1a67d9108e73",
        "ResourceName": "api",
        "ResourceType": "Project",
        "RegionId": "eu-central",
        "BilledCost": "0.033462",
        "EffectiveCost": "0.033462",
        "ListCost": "0.033300",
        "ConsumedQuantity": "0.0333",
        "ConsumedUnit": "vCPU-months"
      }
    ]
  }
}

{
  "errors": [
    {
      "type": "field",
      "value": "<unknown>",
      "msg": "Invalid value",
      "path": "name",
      "location": "body"
    }
  ]
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

{
  "message": "Project not found",
  "data": {}
}

Authorizations

x-brimble-key

string

header

required

API key created in the dashboard under Settings → API keys. Each key carries permission scopes; every endpoint lists the scope it needs.

Query Parameters

charge_period_start

string<date-time>

Start of the window, ISO 8601. Required unless invoice_id is sent.

charge_period_end

string<date-time>

End of the window, exclusive. At most 366 days after the start. Required unless invoice_id is sent.

invoice_id

string

Export a single finalized invoice instead of a window.

teamId

string

Team to read. Ignored for a team API key, which always reads its own team.

Response

FOCUS rows for the window.

message

string

data

object

Show child attributes

Last modified on November 11, 2026

Getting started

Projects

Deployments and Logs

Environments

Secrets

Webhooks

Git Providers

Domains

Databases

Log Drains

Sandboxes

CI Runners

Object Storage

Scaling and Networking

Teams

Catalog

Billing

Export costs as FOCUS 1.2 rows

Authorizations

Query Parameters

Response