# List the calling user's budget spend statuses

Launch stage: Beta

`GET /api/2.1/{parent=accounts/*}/budget-spend-statuses`

List the calling user's live spend against the blocking thresholds across the account's Unity
 Gateway budgets. Any account user can call this for their own spend. Spend is reported in USD
 at list price and is near-real-time, so it may differ slightly from billing data. By default,
 returns every budget in the account that has a blocking threshold. Use `filter` to narrow
 results by workspace.

API scopes: billing

## Path parameters

- `parent` (string, required)
  The parent account whose budget spend statuses to list, of the form `accounts/{account_id}`.

## Query parameters

- `page_token` (string, optional)
  A page token from a previous `ListBudgetSpendStatuses` response, used to fetch the next page.
   Requests the first page if absent. All other request parameters except `page_size` must match
   the request that returned the token; otherwise the request fails with INVALID_PARAMETER_VALUE.
- `page_size` (int32, optional)
  The maximum number of spend statuses to return per page. If unspecified or 0, at most 100 are
   returned. The maximum value is 100; values above 100 are coerced to 100. Negative values fail
   with INVALID_PARAMETER_VALUE. The server may return fewer results than requested, including
   zero, even when more pages remain; page until `next_page_token` is absent.
- `filter` (string, optional)
  A filter expression that narrows the returned budgets by workspace. Only `workspace_id` is
   supported, in lower case with numeric workspace IDs, for example `workspace_id = 123` or
   `workspace_id IN (123, 456)`. Matches budgets that apply to any of the listed workspaces,
   including budgets that apply to all workspaces. Any other expression, such as an empty `IN ()`
   list, fails with INVALID_PARAMETER_VALUE. If empty, returns every budget in the account that has
   a blocking threshold.

## Returns

Returns a list of BudgetSpendStatus objects.

## Response

```json
{
  "budget_spend_statuses": [
    {
      "name": "string",
      "alert_spend_statuses": [
        {}
      ]
    }
  ],
  "next_page_token": "string"
}
```