Skip to content

Get billing usage for a month

GET /billing/usage

Query Parameters

team_idstring · uuid
required
Example: 05daecaf-4365-42e8-8370-8127de5dd717
period_startstring · date

First day of the month to report, as YYYY-MM-01.

Example: 2026-08-01

Response Body

countsobject

Measured counts for the period. A metric is null when it could not be measured for this period (API calls past VictoriaLogs retention) — never a zero that was not observed. This can happen on an invoiced month too, not only a skipped one; only the affected metric is null, not the whole response.

active_connectioninteger
api_callinteger
connectorinteger
superquery_accountinteger
linesobject[]

The priced breakdown. Empty for a skip whose pricing itself is unreliable (a component past VictoriaLogs retention); populated for other skips (exempt, no Stripe customer, nothing to bill) so what the month would have cost is still visible, and always populated for an invoiced month.

amount_centsinteger

Net amount charged.

Example: 28800
descriptionstring
Example: Active connections — August 2026 (42 used, 10 included)
discount_centsinteger
Example: 3200
discount_percentnumber
Example: 10
gross_amount_centsinteger

Amount before discount.

Example: 32000
included_quantityinteger
keystring
Example: usage:active_connection
kindstring
Possible values:
base_feeusagefixed
measured_quantityinteger
metricstring
Possible values:
connectoractive_connectionapi_callsuperquery_account
overage_quantityinteger

Usage lines only — measured minus included, before block rounding.

Example: 32
period_endstring · date

Exclusive end (first day of the next period).

period_startstring · date
quantityinteger

Units charged; for usage lines the number of blocks of unit_size.

Example: 32
unit_price_centsnumber

Price per charged unit (per block for usage lines).

Example: 1000
unit_sizeinteger

Usage lines only — units per block.

Example: 1
periodobject
endstring · date
labelstring
Example: August 2026
startstring · date
sourcestring
Possible values:
snapshotlive
total_centsinteger

Net amount priced for the period. null only when the month's snapshot was skipped because a metric it needed could not be measured — never a zero that was not billed. An unmeasurable metric on an invoiced month does not null this out; it prices normally from what was measurable. On a skip whose priced metrics were all measurable, this is a real 0 (nothing was billed) even though lines above is still populated with what the period would have cost — the two intentionally disagree there, since one states what happened and the other what would have.

curl -X GET 'https://api.truto.one/billing/usage' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.truto.one/billing/usage', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/billing/usage"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
}

response = requests.get(url, headers=headers, params=params)
print(response.json())