> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# vantage_budget_alerts (Data Source)

> Terraform data source reference for vantage_budget_alerts (Data Source). Auto-generated from the vantage-sh/terraform-provider-vantage repository.

<Note>
  This page is auto-generated based on the official [Terraform documentation](https://registry.terraform.io/providers/vantage-sh/vantage/latest/docs).
</Note>

## Overview

Use this data source with the [Vantage Terraform provider](/terraform). For installation and authentication, see the [Terraform provider quickstart](/terraform#quickstart). The schema below is generated directly from the provider source.

## Example Usage

```terraform theme={null}
data "vantage_budget_alerts" "demo" {
  budget_token = vantage_budget.demo_budget.token
}
```

## Schema

### Optional

* `budget_token` (String) Filter by budget token.
* `workspace_token` (String) Filter by workspace token.

### Read-Only

* `budget_alerts` (Attributes List) (see [below for nested schema](#nestedatt--budget_alerts))

<a id="nestedatt--budget_alerts" />

### Nested Schema for `budget_alerts`

Read-Only:

* `budget_tokens` (List of String) The tokens for the Budgets that the Budget Alert is monitoring to trigger alerts on.
* `created_at` (String) The date and time, in UTC, the Budget Alert was created. ISO 8601 Formatted.
* `duration_in_days` (Number) The API's nullable integer duration. A null value means the full month; the `vantage_budget_alert` resource writes the same state as `""`.
* `id` (String) The id of the resource
* `integration_provider` (String) The provider used for sending alerts. This must be configured in the console. Possible values are: slack, microsoft\_graph.
* `period_to_track` (String) The period tracked on the alert. Used with duration\_in\_days to determine the time window of the alert. Possible values: start\_of\_the\_month, end\_of\_the\_month.
* `recipient_channels` (List of String) The channels receiving the alerts. Requires an integration provider to be connected.
* `recipient_emails` (List of String) The complete recipient address list, including organization users and freeform addresses on verified domains.
* `threshold` (Number) Alerts only send if they reach this number (as a percentage). When threshold is 100, that means alerts are triggered once costs reach 100% of the budget.
* `token` (String)
* `user_token` (String) The token for the User who created this BudgetAlert.
* `user_tokens` (List of String) The organization-user subset of recipients. Freeform verified-domain addresses are excluded; recipient\_emails contains the complete address list.
* `workspace_token` (String) The token for the Workspace the ResourceReport is a part of.