# AWS Price List Bulk API · Records list

Get market and financial data with AWS Price List Bulk API · Records list from Alexandria through one Spiral API key. To collect every price row of an offer in one region for one version, page by page, from the first call (no `continuation`) until `meta.page.continuation` is `exhausted`. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Finance
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `pricing-us-east-1-amazonaws-com/cloud-pricing/records_list`
- Page: https://spiral.ai/tools/alexandria/pricing-us-east-1-amazonaws-com/cloud-pricing/records_list

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `region` (required) | text |  | — | AWS region code as a path segment of the region index, e.g. `us-east-1`, `eu-west-1`, `us-east-1-bog-1` (Local Zone) or `ap-northeast-1-wl1-nrt1` (Wavelength). Pattern: ^[a-z]{2}(-[a-z0-9]+){2,5}$. |
| `version` (required) | text |  | — | Publication version id (`YYYYMMDDHHMMSS`, from versions_list) or `current`, which is resolved to the current version id through the region index so every file URL stays versioned. Pattern: ^([0-9]{14}\|current)$. |
| `offer_code` | text |  | — | Offer code from offers_list, e.g. `AmazonEC2`, `AmazonRDS`, `AmazonS3` (the `offerCode` key of the offer index and the `serviceCode` CSV column). Pattern: ^[A-Za-z0-9]{2,64}$. |
| `continuation` | text |  | — | Opaque cursor from the previous page (`meta.page.next_cursor`); carries the pinned file URL, ETag, size, byte offset and header. |
| `window_bytes` | number | 4096 to 8388608 | 4194304 | Bytes requested per page with `Range`. A 4 MiB window of the EC2 file (about 5,400 rows) returned in roughly 1 s and 8 MiB (about 10,900 rows) in 2 s through the ISP proxy; 16 MiB exceeded the 256 MB guest memory, so 8 MiB is the ceiling. The first window must hold the 5 metadata lines and the header. |
| `savings_plan_offer` | text |  | — | Savings plan offer family from offers_list `savings_plan_offer`: `AWSComputeSavingsPlan`, `AWSDatabaseSavingsPlans` or `AWSMachineLearningSavingsPlans`. Pattern: ^[A-Za-z0-9]{2,64}$. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "pricing-us-east-1-amazonaws-com/cloud-pricing/records_list",
    "input": {
      "region": "<region>",
      "version": "<version>",
      "offer_code": "<offer_code>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=pricing-us-east-1-amazonaws-com%2Fcloud-pricing%2Frecords_list

## Common questions

### AWS Price List Bulk API · Records list

**How much does AWS Price List Bulk API · Records list cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use AWS Price List Bulk API · Records list through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "pricing-us-east-1-amazonaws-com/cloud-pricing/records_list"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use AWS Price List Bulk API · Records list?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use AWS Price List Bulk API · Records list?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

