Get a list of governance nodes
Queries the customer's governance hierarchy tree, returning a cursor-paginated list of nodes with their usage configuration (limit, cadence, scope) and current usage, sortable and filterable by usage. Each node carries parentId so the tree can be rebuilt client-side. Usage is read from a periodically-refreshed read model and never gates access.
Path parameters
The customer ID.
Query parameters
Maximum number of items to return
Return items that come after this cursor
Feature ids to include, repeated per value (e.g. ?featureIds=ai-tokens&featureIds=seats). Omit both featureIds and currencyIds for tree mode — every node in the hierarchy with no usage configuration attached.
Currency ids to include, repeated per value (e.g. ?currencyIds=credits). Omit both featureIds and currencyIds for tree mode.
Sort key: utilization (default, cross-capability-safe), currentUsage, usageLimit, scopeSize, id, or createdAt.
Sort direction: asc or desc (default desc).
Filter by configuration scope: all (default), nodeWide ([] only), or scoped (non-empty only).
Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over limit).
Filter to one or more entity types, repeated per value (e.g. ?entityTypeIds=team&entityTypeIds=user).
Case-insensitive substring match on the entity id (%/_ matched literally).
Headers
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Response
A paginated list of governance tree nodes with usage configuration and current usage.