# Cloud Billing budgets with spend from the billing export

Source: https://docs.levelfour.ai/api-reference/google-cloud/get-providers-gcp-budgets


## GET /api/v1/providers/gcp/budgets

### Authentication

Send `Authorization: Bearer <token>`.

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (string, required)
- `data` (object, required)
  - `items` (array of object, required)
    - `budget_id` (string, required)
    - `display_name` (string, required)
    - `amount_usd` (number, nullable, required)
    - `amount_kind` (one of `specified`, `last_period`, required)
    - `calendar_period` (string, nullable, required): MONTH, QUARTER or YEAR; null for a custom period
    - `spent` (number, required): Spend in the current period, on the budget's own credit treatment
    - `forecast` (number, nullable, required): Straight-line projection to the end of the current period
    - `burn_pct` (number, nullable, required)
    - `thresholds` (array of number, required): Alert thresholds as percents of the amount
    - `approximate` (boolean, required): True when the budget's scope cannot be reproduced exactly

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)