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
enabled_connectorinteger

Null on a snapshot written before this metric existed.

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
connector_groupstring

Usage lines only — which connectors the count covers. Absent on a line written before connector groups existed, which means all.

Possible values:
allgoogle_workspaceother
descriptionstring

Invoice wording. Usage lines mention the included allowance only when the component has one.

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
integration_idstring

Connector-term lines only — the connector the term is for.

integration_namestring

Connector-term lines only — the connector's name.

Example: salesforce
keystring

Stable per plan and period. usage:<metric> for a usage line over all connectors, usage:<metric>@<connector_group> for a grouped one; term:<component key>:<integration id>:<term start> for a connector billed in advance.

Example: usage:active_connection@google_workspace
kindstring
Possible values:
base_feeusagefixedconnector_term
measured_quantityinteger
metricstring
Possible values:
connectorenabled_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
tierobject

Usage lines of a tiered component only — the band this line prices. Keys are usage:<component key>:tier:<index> (per-unit) and …:tier:<index>:flat (the band's flat amount).

4 properties
frominteger

First unit of the band (1-based, inclusive).

indexinteger
kindstring
Possible values:
unitflat
tointeger

Last unit of the band (inclusive); null for "and up".

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())