Using the AWS Price List Bulk API - AWS Billing

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.

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.