NetBird Full API Reference + Read-Only MCP Prototype
GET/api/agent-network/consumption

List Agent Network consumption counters

Returns every per-(dimension, window) consumption counter recorded for the account, ordered window-newest-first. Empty list when nothing has been consumed yet.

4 status codes
200A JSON Array of consumption counter rows
cost_usdnumberrequired
Total USD spend booked against this dimension for the window.
dimension_idstringrequired
NetBird user id (when `dimension_kind=user`) or NetBird group id (when `dimension_kind=group`).
dimension_kindstringrequired
Whether this row counts a single end user or a single source group across every member.
Allowed:usergroup
tokens_inputintegerrequired
Total input tokens consumed within the window.
tokens_outputintegerrequired
Total output tokens consumed within the window.
updated_atstringoptional
Timestamp of the last increment recorded for this row.
window_secondsintegerrequired
Length of the aligned window this counter covers, in seconds. Distinct window lengths produce independent counters even on the same dimension.
window_start_utcstringrequired
UTC start of the aligned window this counter covers. Aligned to the unix epoch so every node computes the same boundary.
401Requires authentication
403Forbidden
500Internal Server Error

Error handling

A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 500 is returned: Internal Server Error.