AWS Budgets
amazonaws · Cloud
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 for the Amazon Web Services Budgets feature. Budgets provide you with a way to see the following information: How close your plan is to your budgeted amount or to the free tier limits Your usage-to-date, including how much you've used o
Authentication
Sample Requests
Describes a budget action history detail.
Hover any highlighted part to learn what it does
| X-Amz-Target | AWSBudgetServiceGateway.DescribeBudgetActionHistories |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionHistories"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "AWSBudgetServiceGateway.DescribeBudgetActionHistories"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'AWSBudgetServiceGateway.DescribeBudgetActionHistories'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "AWSBudgetServiceGateway.DescribeBudgetActionHistories")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "AWSBudgetServiceGateway.DescribeBudgetActionHistories"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionHistories?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionHistories"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Describes all of the budget actions for an account.
Hover any highlighted part to learn what it does
| X-Amz-Target | AWSBudgetServiceGateway.DescribeBudgetActionsForAccount |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionsForAccount"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "AWSBudgetServiceGateway.DescribeBudgetActionsForAccount"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'AWSBudgetServiceGateway.DescribeBudgetActionsForAccount'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "AWSBudgetServiceGateway.DescribeBudgetActionsForAccount")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "AWSBudgetServiceGateway.DescribeBudgetActionsForAccount"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForAccount?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionsForAccount"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Describes all of the budget actions for a budget.
Hover any highlighted part to learn what it does
| X-Amz-Target | AWSBudgetServiceGateway.DescribeBudgetActionsForBudget |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionsForBudget"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "AWSBudgetServiceGateway.DescribeBudgetActionsForBudget"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'AWSBudgetServiceGateway.DescribeBudgetActionsForBudget'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "AWSBudgetServiceGateway.DescribeBudgetActionsForBudget")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "AWSBudgetServiceGateway.DescribeBudgetActionsForBudget"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/budgets/2016-10-20/#X-Amz-Target=AWSBudgetServiceGateway.DescribeBudgetActionsForBudget?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: AWSBudgetServiceGateway.DescribeBudgetActionsForBudget"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with AWS Budgets?
AWS Budgets is a Cloud API. Developers commonly use cloud APIs for:
- provisioning and managing cloud infrastructure
- automating deployments and container orchestration
- monitoring uptime and performance metrics
- managing storage buckets and databases
- setting up auto-scaling and load balancing
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. AWS Budgets is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?