v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
billing

Get user states for a multi-user budget

Lists per-user budget state for a multi-user customer scoped budget. The authenticated user must be an enterprise admin or billing manager.

get/enterprises/{enterprise}/settings/billing/budgets/{budget_id}/user-states

Path parameters

enterprisestring required

The slug version of the enterprise name.

budget_idstring required

The ID corresponding to the budget.

Query parameters

pageinteger

The page number of results to fetch.

per_pageinteger

The number of results per page.

sort_order'0' | '1'

Sort order for results. 0 for descending, 1 for ascending.

userstring

Filter user states to a specific user login.

threshold_lower_boundinteger

Filter user states whose threshold percentage is at or above this value.

threshold_upper_boundinteger

Filter user states whose threshold percentage is at or below this value.

Response

Response when getting per-user states for a multi-user budget

has_next_pageboolean required

Indicates if there are more pages of results available.

total_countinteger required

Total number of user state entries matching the query.