Using the AWS Price List Bulk API - AWS Billing

Using the AWS Price List Bulk API

To provide feedback about AWS Price List, complete this short survey. Your responses will be anonymous. Note: This survey is in English only.

We recommend that you use the Price List Bulk API when you want to do the following tasks:

  • Consume large amounts of product and pricing information for AWS services.

  • Consume product and pricing information with a high throughput for an AWS service, such as processing in bulk.

Also, when the Price List Query API doesn't provide sufficient throughput and quotas for your use case, use the Price List Bulk API.

IAM permissions

An AWS Identity and Access Management (IAM) identity, such as a user or role, must have permission to use the Price List Bulk API. To grant access, use the following IAM policy.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "pricing:DescribeServices", "pricing:GetPriceListFileUrl", "pricing:ListPriceLists" ], "Resource": [ "*" ] } ] }

This policy only grants access to the Price List Bulk API. To also grant access to the Price List Query API, see the example Find products and prices IAM policy.


The Price List Bulk API provides the following endpoints:




The AWS Region is the API endpoint for the Price List Bulk API. The endpoints aren't related to product or service attributes.

To call the Price List Bulk API, see the following examples.


In the following example, specify the region_name and use it to create the PricingClient.

public class Main { public static void main(String[] args) { // Create pricing client PricingClient client = PricingClient.builder() .region(Region.US_EAST_1)// or Region.AP_SOUTH_1 .credentialsProvider(DefaultCredentialsProvider.builder().build()) .build(); ); } }
AWS Command Line Interface

Specify the Region with the following command.

aws pricing describe-services --region us-east-1


Some Price List Bulk API operations are throttled by using a token bucket scheme to maintain service availability. These quotas are per AWS account on a per Region basis. Quotas for each API operation are shown in the following table.

API operation Token bucket size Refill rate per second
DescribeServices 10 5
GetPriceListFileUrl 10 5
ListPriceLists 10 5

For more information about service quotas (formerly referred to as limits), see AWS service quotas in the AWS General Reference.