# The BudgetSpendStatus object

The calling user's live spend against the blocking thresholds of a single budget.

## Attributes

- `name` (string, Beta, ID, Immutable)
  The resource name of this budget spend status, of the form
   `accounts/{account_id}/budget-spend-statuses/{budget_id}`.
- `alert_spend_statuses` (array of object, Beta)
  The calling user's spend against each blocking threshold on this budget, one entry per scope
   type and time period. A blocking threshold is a threshold that, once reached, blocks further
   requests through Unity Gateway.
  - `scope_type` (string, Beta)
    Whether the threshold is evaluated per individual user
     (`ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER`) or on the shared spend across all users
     (`ALERT_CONFIGURATION_SCOPE_TYPE_SHARED`).
    Possible values:
    - `ALERT_CONFIGURATION_SCOPE_TYPE_SHARED`
    - `ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER`
  - `time_period` (string, Beta)
    The time window the threshold applies to, for example `MONTH`.
    Possible values:
    - `MONTH`
  - `spend` (string, Beta)
    The calling user's live spend against this threshold, in USD at list price. Returns "0" if the
     caller has no usage. Omitted for shared thresholds, where only `percent_consumed` is returned.
  - `threshold` (string, Beta)
    The calling user's effective threshold, in USD at list price. The effective threshold is the
     actual threshold amount that applies to the user, after adjusting for any user or group
     overrides. Omitted for shared thresholds, where only `percent_consumed` is returned.
  - `percent_consumed` (string, Beta)
    Percentage of the threshold consumed, as a decimal string rounded down to one decimal place (for
     example, "68.4" means 68.4%). May exceed 100 when spend is over the threshold. Returns "0.0" if
     there's no spend, and is omitted if the threshold is $0. For shared thresholds, this is the
     only value returned; the absolute `spend` and `threshold` dollar amounts are withheld.

## Example

```json
{
  "name": "string",
  "alert_spend_statuses": [
    {
      "scope_type": "ALERT_CONFIGURATION_SCOPE_TYPE_SHARED",
      "time_period": "MONTH",
      "spend": "string",
      "threshold": "string",
      "percent_consumed": "string"
    }
  ]
}
```