Using the AWS Price List Query API - AWS Billing

Using the AWS Price List Query 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 Query API when you want to:

  • Find pricing information about a product.

  • Search for products and rates that match your filters.

  • Quickly find products and prices that you need when you're developing applications that have limited resources, such as front-end environments.

IAM permissions

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

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

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


The Price List Query API provides the following endpoints:




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

To call the Price List Query 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 Query 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. The following table shows the quotas for each API operation.

API operation Token bucket size Refill rate per second
DescribeServices 10 5
GetAttributeValues 10 5
GetProducts 10 5

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