# AWS Budgets API

> AWS Budgets API on Apizie: 23 endpoints (Creates a budget and, if included, notifications and subscribers. Only one of BudgetLimit or…, Creates a budget action., Creates a notification. You must create the budget before you create the associated notification., Creates a subscriber. You must create the associated budget and notification before you create the subscriber., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-budgets`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-budgets
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-budgets/openapi.json

Use the Amazon Web Services Budgets API to plan your service usage, service costs, and instance reservations. This API reference provides descriptions, syntax, and usage examples for each of the actions and data types…

## Endpoints

### Creates a budget and, if included, notifications and subscribers. Only one of BudgetLimit or…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Creates a budget action.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-budget-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Creates a notification. You must create the budget before you create the associated notification.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Creates a subscriber. You must create the associated budget and notification before you create the subscriber.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-subscriber` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Deletes a budget. You can delete your budget at any time. Deleting a budget also deletes the notifications…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/delete-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Deletes a budget action.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/delete-budget-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Deletes a notification. Deleting a notification also deletes the subscribers that are associated with the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/delete-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Deletes a subscriber. Deleting the last subscriber to a notification also deletes the notification.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/delete-subscriber` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Describes a budget. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits , see…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Describes a budget action detail.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Describes a budget action history detail.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-action-histories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Describes all of the budget actions for an account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-actions-for-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Describes all of the budget actions for a budget.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-actions-for-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the budget names and notifications that are associated with an account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-notifications-for-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Describes the history for DAILY , MONTHLY , and QUARTERLY budgets. Budget history isn't available for ANNUAL…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budget-performance-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the budgets that are associated with an account. The Request Syntax section shows the BudgetLimit…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-budgets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the notifications that are associated with a budget.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-notifications-for-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the subscribers that are associated with a notification.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/describe-subscribers-for-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Executes a budget action.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/execute-budget-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend .…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/update-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Updates a budget action.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/update-budget-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Updates a notification.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/update-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Updates a subscriber.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/update-subscriber` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-budget" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Budgets API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-budgets/create-budget with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Budgets API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Budgets itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Budgets API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-budgets.

### What is the status of the AWS Budgets API?
Needs your own provider key (bring your own key)