

# Getting price list files manually
<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files-manually"></a>


|  | 
| --- |
| To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

We recommend that you use the Amazon Price List Bulk API to find and download price list files programmatically. For more information, see [Step 1: Finding available Amazon Web Services services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services).

If you don't want to use the Amazon Price List Bulk API, you can download the price list files manually. You can skip to the relevant topics if you already have the information that you need.

**Topics**

## Step 1: Finding available Amazon Web Services services
<a name="fetching-price-list-manually-step-1"></a>


|  | 
| --- |
| To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

You can use the service index file to find available Amazon Web Services services and Savings Plans that are provided by the Amazon Price List Bulk API.

To download the service index file, navigate to the following URL.

```
https://pricing.cn-north-1.amazonaws.com.cn/offers/v1.0/cn/index.json
```

In the service index file, you can search for the service to find its prices. To download the service-specific price list file, use either the `offerCode` or `serviceCode`.

For more information, see the following topics:
+ [Reading the service index file](bulk-api-reading-price-list-files.md#reading-service-index-files)
+ [Step 1: Finding available Amazon Web Services services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services)

## Step 2: Finding available versions for an Amazon Web Services service
<a name="fetching-price-list-files-manually-step-2"></a>


|  | 
| --- |
| To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

For an Amazon Web Services service or Savings Plan that you retrieved in [step 1](#fetching-price-list-manually-step-1), you can find all the historical versions of the price lists by using the [service version index file](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md).

To download the service version index file, use the `serviceCode` or `savingsPlanCode`. To find the values for `serviceCode` and `savingsPlanCode`, see [Step 1: Finding available Amazon Web Services services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services).

To download the service version index file for an Amazon Web Services service, navigate to the following URL. Replace {{<serviceCode>}} with your own information.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/{{<serviceCode>}}/index.json
```

For example, Amazon Elastic Compute Cloud (Amazon EC2) appears in a URL like the following URL.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonEC2/index.json
```

**Note**  
In addition to the versions available in the service version index file, there is another version named `current`. The `current` version points to the latest version of the price list files for a specific Amazon Web Services service.

To download the latest service version index file for Savings Plan, specify `savingsPlanCode` and `current` in the URL. Replace {{<savingsPlanCode>}} with your own information.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/{{<savingsPlanCode>}}/current/index.json
```

For example, the current version of `AWSComputeSavingsPlan` appears like the following URL.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/AWSComputeSavingsPlan/current/index.json
```

For more information, see [Reading the service version index file](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md).

## Step 3: Finding available Amazon Web Services Regions for a version of an Amazon Web Services service
<a name="fetching-price-list-files-manually-step-3"></a>


|  | 
| --- |
| To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

For a version of an Amazon Web Services service or Savings Plan in [the previous step](#fetching-price-list-files-manually-step-2), you can find all the Amazon Web Services Regions and edge locations in which an Amazon Web Services service provides products for purchase.

To download the service Region index file for an Amazon Web Services service, navigate to the following URL. Replace {{<serviceCode>}} and {{<version>}} with your own information.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/{{<serviceCode>}}/{{<version>}}/region_index.json
```

For example, the service code for `AmazonRDS` and its `current` version has the following URL.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonRDS/current/region_index.json
```

To download the service Region index file for Savings Plan, navigate to the following URL. Replace {{<savingsPlanCode>}} with your own information.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/{{<savingsPlanCode>}}/current/region_index.json
```

For example, a Savings Plan for `AWSComputeSavingsPlan` and its `current` version has the following URL.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/AWSComputeSavingsPlan/current/region_index.json
```

For more information, see [Reading the service Region index file](reading-service-region-index-files.md).

## Step 4: Finding available price lists for an Amazon Web Services Region and version of an Amazon Web Services service
<a name="fetching-price-list-files-manually-step-4"></a>


|  | 
| --- |
| To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

In the previous steps, you retrieved the following information about an Amazon Web Services service:
+ Service code
+ Savings Plan code
+ Version
+ Amazon Web Services Regions

Next, you can use this information to find the prices in the service price list files. These files are available in JSON and CSV formats.

**Contents**
+ [Finding service price list files](#fetching-price-list-files-manually-step-4-finding-service-price-list-files)
+ [Finding service price list files for Savings Plan](#find-service-price-list-files-for-savings-plans)

### Finding service price list files
<a name="fetching-price-list-files-manually-step-4-finding-service-price-list-files"></a>

The service price list file provides the service related details, such as the following: 
+ The effective date of the prices in that file
+ The version of the service price list
+ The list of offered products and their details, along with prices in JSON and CSV formats

In the following URLs, you can change the URL to specify the format that you want (JSON or CSV). 

To download the service price list file, navigate to the following URL. Replace each {{user input placeholder}} with your own information. 

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/{{<serviceCode>}}/{{<version>}}/{{<regionCode>}}/index.{{<format>}}
```

The following examples are for Amazon Relational Database Service (Amazon RDS). This service appears as AmazonRDS in the URL.

**Example: Current version of the price list file for Amazon RDS**  
To get the current version of the price list file for Amazon RDS, use the following URL.  
CSV format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonRDS/current/cn-northwest-1/index.csv
```
JSON format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonRDS/current/cn-northwest-1/index.json
```

**Example: Specific version of the price list file for Amazon RDS**  
To get the specific version of the price list file for Amazon RDS, use the following URL.  
CSV format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonRDS/20230328234721/cn-northwest-1/index.csv
```
JSON format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/offers/v1.0/cn/AmazonRDS/20230328234721/cn-northwest-1/index.json
```

### Finding service price list files for Savings Plan
<a name="find-service-price-list-files-for-savings-plans"></a>

The service price list file for Savings Plan provides Savings Plan related details, such as the following:
+ The effective date of the prices in that file
+ The version of the service price list
+ The list of offered products and their details, along with prices in JSON and CSV formats

In the following URLs, you can change the URL to specify the format that you want (JSON or CSV). 

To download the service price list files for Savings Plan, use the following URL. Replace each {{user input placeholder}} with your own information.

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/{{<savingsPlanCode>}}/{{<version>}}/{{<regionCode>}}/index.json
```

**Example: Service price list file for Amazon SageMaker AI**  
To get a specific version (`20230509202901`) of the price list file for SageMaker AI (`AWSComputeSavingsPlan`), use the following URL.  
CSV format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/AWSComputeSavingsPlan/20230509202901/cn-northwest-1/index.csv
```
JSON format  

```
https://pricing.cn-northwest-1.amazonaws.com.cn/savingsPlan/v1.0/cn/AWSComputeSavingsPlan/20230509202901/cn-northwest-1/index.json
```

For more information, see [Reading the service price list files](reading-service-price-list-files.md).