# Canada Energy Regulator (CER) open data · Throughput

Get industry and reference data with Canada Energy Regulator (CER) open data · Throughput from Alexandria through one Spiral API key. Questions like "how full was Trans Mountain at Westridge in 2025", "NGTL East Gate daily flows last week", "Enbridge Mainline throughput vs capacity at Gretna". It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Industry Data
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `cer-rec-gc-ca/energy-data/throughput`
- Page: https://spiral.ai/tools/alexandria/cer-rec-gc-ca/energy-data/throughput

## 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 |
| --- | --- | --- | --- | --- |
| `pipeline` (required) | text |  | — | Pipeline system: a slug (`trans-mountain`, `ngtl`, `tc-mainline`, `enbridge-mainline`, `keystone`, `westcoast`, `alliance`), the CER name or a common alias (`TMX`, `NOVA`, `TCPL`, `BC Pipeline`). An unknown name fails with not_found listing the systems that have throughput data. |
| `to` | text |  | — | Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. |
| `from` | text |  | — | Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. |
| `limit` | number | 1 to 500 | 100 | Rows per page. |
| `offset` | number | 0 to … | 0 | `next_offset` from the previous page; repeat the other inputs with it. |
| `product` | text |  | — | Oil product class or part of it (`heavy`, `refined`). |
| `key_point` | text |  | — | Key point name or part of it (`Westridge`, `East Gate`, `Kerrobert`); see `key_points` in any answer. |
| `trade_type` | text |  | — | `intracanada`, `export` or `import`. |
| `granularity` | one of | monthly, daily | monthly | `monthly` (default; daily gas data averaged per month) or `daily` (gas systems only). |

## 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": "cer-rec-gc-ca/energy-data/throughput",
    "input": {
      "pipeline": "<pipeline>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=cer-rec-gc-ca%2Fenergy-data%2Fthroughput

## Common questions

### Canada Energy Regulator (CER) open data · Throughput

**How much does Canada Energy Regulator (CER) open data · Throughput 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 Canada Energy Regulator (CER) open data · Throughput through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "cer-rec-gc-ca/energy-data/throughput"` 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 Canada Energy Regulator (CER) open data · Throughput?**

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

**Can my AI agent use Canada Energy Regulator (CER) open data · Throughput?**

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

