Using the AWS Price List Bulk API
The AWS Price List Bulk API is actually a URL that provides up-to-date pricing information on the current AWS products and services. To access pricing information using the bulk API, download the offer file:
-
Offer file – A JSON or CSV file that lists the products and prices for either a single AWS service in all Regions or a single AWS service in a specific Region. For more information, see Downloading an offer file.
To find a list of all available offer files, download the offer index file:
-
Offer index file – A JSON file that lists the supported AWS services, with a URL for each offer file where you can download pricing details. The file also includes metadata about the offer index file itself, URLs for service offer files, and URLs for regional offer index files. For more information, see Downloading an offer index file.
Offer files don't include information about expiring free tier offers or Amazon EC2 Spot Instances.
Note
The AWS Price List Bulk API provides pricing details for your information only. If there is a discrepancy between the offer file and a service pricing page, AWS charges the prices that are listed on the service pricing page. For more information about AWS service pricing, see Cloud Services Pricing
Topics
To receive SNS notifications when prices change, see Setting up notifications.
Downloading an offer index file
To download the offer index file, go to the following URL
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/index.json
The URL opens the offer index file. In the offer index file, search for the service that you want prices for. You need the service code to download the service-specific offer file. To download an offer index file for a specific service and Region, find the service that you want prices for and open the regional offer index file.
For more information, see Reading the offer index file.
Downloading an offer file
To download the offer file for the service that you want, go to the URL for that
offer file. For example, to download the current JSON version of the Amazon EC2 offer
file, go to the following URL
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonEC2/current/index.json
The offer index file includes the JSON URLs. To download the CSV version, replace
the .json
extension in the offer file URL with .csv
. If
you want to download the offer file for a specific service and you know the service
code, replace the AmazonEC2
in the URL with the service code to
download the offer file for that service. If you don't know the service code,
download the offer index file to find it. If you want to download the offer file for
a specific service in a specific Region and you know the service code and Region,
use the URL for that regional offer file.
For example, to download the current JSON version of the
Amazon EC2 offer file for US East (N. Virginia), use the following URL
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonEC2/current/us-east-1/index.json
To download the offer file for Savings Plans that apply to a
particular service, go to the Savings Plans URL for that service. For example, to download
the current JSON version of Compute Savings Plans, use the following: URL
You can use this URL for the regional offer files directly.
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/index.json
To download the current JSON version of SageMaker Savings Plans, use the
following URL
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSMachineLearningSavingsPlans/current/index.json
If you access the offer files programmatically, you can use the offer index file to find the current URLs. For more information about the offer index file, see Finding prices in an offer file and Reading an offer file.