---
type: "firecrawl-provider"
description: "The Canada Energy Regulator's open data on www.cer-rec.gc.ca, read live and keyless from the CSV files the CER publishes under the Open Government Licence - Canada: pipeline profiles (operator, route, capacity, financials), daily and monthly pipeline throughput and capacity, pipeline tolls with their tariffs and REGDOCS filing ids, incidents at regulated pipelines since 2008, regulatory instruments (certificates, orders, licences, decision letters) with REGDOCS filing ids, Canada's Energy Future projections to 2050, and energy trade and production statistics (crude, gas, LNG, NGL, refined products, electricity). Every answer names its source file and carries the licence attribution."
use_when: "The Canada Energy Regulator's open data on www.cer-rec.gc.ca, read live and keyless from the CSV files the CER publishes under the Open Government Licence - Canada: pipeline profiles (operator, route, capacity, financials), daily and monthly pipeline throughput and capacity, pipeline tolls with their tariffs and REGDOCS filing ids, incidents at regulated pipelines since 2008, regulatory instruments (certificates, orders, licences, decision letters) with REGDOCS filing ids, Canada's Energy Future projections to 2050, and energy trade and production statistics (crude, gas, LNG, NGL, refined products, electricity). Every answer names its source file and carries the licence attribution."
categories: "Public records"
capabilities: 7
credits_per_call: 5
---
# Canada Energy Regulator (CER) open data on Firecrawl Alexandria

The Canada Energy Regulator's open data on www.cer-rec.gc.ca, read live and keyless from the CSV files the CER publishes under the Open Government Licence - Canada: pipeline profiles (operator, route, capacity, financials), daily and monthly pipeline throughput and capacity, pipeline tolls with their tariffs and REGDOCS filing ids, incidents at regulated pipelines since 2008, regulatory instruments (certificates, orders, licences, decision letters) with REGDOCS filing ids, Canada's Energy Future projections to 2050, and energy trade and production statistics (crude, gas, LNG, NGL, refined products, electricity). Every answer names its source file and carries the licence attribution.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `cer-rec-gc-ca`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/cer-rec-gc-ca)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/openapi.json)

## Capabilities

- [Energy future](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/energy_future): Projections from Canada's Energy Future, the CER's long-term energy supply and demand outlook to 2050, read from the edition's open data (2026, 2023 or 2021): benchmark oil and gas prices, crude oil, natural gas, NGL and hydrogen production, electricity capacity, generation and interchange, end-use demand and prices by sector, primary demand, greenhouse gas emissions, macro indicators and gas drilling, by scenario (e.g. Canada Net-zero, Current Measures), region and year. Filter by scenario, region, variable, sector or type and years; each answer lists the dataset's scenarios, regions, variables, categories and units to refine with.
- [Energy statistics](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/energy_statistics): The CER's energy market and commodity statistics as open data: crude oil exports by US PADD, natural gas exports by port with values and prices, LNG exports by terminal and cargo, NGL and refined product exports, electricity exports and imports by province and US state with prices, estimated crude oil and marketable gas production by province, refinery crude runs, generating capacity and oil pipeline apportionment, monthly, weekly or annual. Filter any column by value (`filters`) and by period; newest first, paged. Each answer names the columns and lists the values of the categorical ones.
- [Incidents](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/incidents): Incidents reported to the CER at federally regulated pipelines and facilities since 2008, from the CER's comprehensive incident open data (about 2,000 incidents): number, types (release of substance, fire, explosion, serious injury, operation beyond design limits...), reported, occurrence and closed dates, company, province, nearest town and coordinates, substance and volume released, significance, what and why it happened, pipeline or facility, injuries, fatalities and evacuations, emergency level and investigation type. Look one up by incident number or filter by company, province, substance, type, significance, status, words and reported date; newest first, paged, with totals by year.
- [Pipelines](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/pipelines): Key facts on the major CER-regulated oil and gas pipelines from the CER's Pipeline Profiles open data: operator and parent company, route, length, commodity, capacity, start year, interconnections, financial regulation group, links to the REGDOCS facility and toll folders and the Pipeline Profile page, and which systems have throughput and toll data here. Naming one pipeline (or company) also returns its annual financial series: revenue, cost of service, net income, rate base, return on equity and more.
- [Regulatory instruments](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/regulatory_instruments): Regulatory instruments the CER (and the NEB before it) issued, from the CER's Regulatory Instruments Report open data (about 17,000): certificates, orders, toll orders, export licences and permits, amending orders and decision letters, each with its file number, company, decision, issued, effective, expiry and sunset dates, Governor in Council and Order in Council approval, and the REGDOCS filing ids of the decision with search links. Look one up by instrument number or filter by type, company, file number, REGDOCS filing id or issued date; newest first, paged.
- [Throughput](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/throughput): Pipeline throughput and capacity at a CER-regulated system's key points, from the CER's Pipeline Throughput and Capacity open data (the numbers behind the Pipeline Profiles traffic charts): natural gas systems daily (returned as monthly averages unless `granularity` is `daily`), oil systems monthly by product. Each row has throughput and capacity in thousand m3/d, GJ/d for gas, committed and available capacity and the reason for variance for oil, and utilization. Filter by key point, product, trade type and date; newest first, paged. 19 systems: NGTL, TC Canadian Mainline, Westcoast, Alliance, Foothills, M&NP, TQM, Brunswick, Suffield, Trans Mountain, Enbridge Mainline, Line 9, Keystone, Cochin, Trans-Northern, Southern Lights, Norman Wells, Westspur and Montreal.
- [Tolls](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/tolls): Tolls on a CER-regulated pipeline from the CER's Major Canadian Natural Gas and Oil Pipeline Tolls open data, collapsed from the CER's daily rows into effective periods: path, service, product, toll and unit, effective from and to, whether it is current, the tariff number it came from and replaced, and the REGDOCS folder and document ids of the tariff filing. Filter by path, service, product, current tolls only, or a date window; newest first, paged. Every answer also lists the system's paths, services and products. 25 systems, including Trans Mountain, Keystone, Enbridge Mainline, NGTL, TC Mainline, Westcoast, Alliance, Express and Cochin.

## 1. Choose this provider when

The Canada Energy Regulator's open data on www.cer-rec.gc.ca, read live and keyless from the CSV files the CER publishes under the Open Government Licence - Canada: pipeline profiles (operator, route, capacity, financials), daily and monthly pipeline throughput and capacity, pipeline tolls with their tariffs and REGDOCS filing ids, incidents at regulated pipelines since 2008, regulatory instruments (certificates, orders, licences, decision letters) with REGDOCS filing ids, Canada's Energy Future projections to 2050, and energy trade and production statistics (crude, gas, LNG, NGL, refined products, electricity). Every answer names its source file and carries the licence attribution.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "cer-rec-gc-ca",
  "capability": "energy-data/energy_future",
  "options": {
    "dataset": "benchmark_prices",
    "edition": 2023,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `category` (string): Sector (`Residential`, `Transportation`) or type (`Primary Fuel`, `Supply`). Example: `<category>`
- `dataset` (string, required): Dataset (2021 lacks the two technology views and greenhouse gas emissions). Example: `benchmark_prices`
- `edition` (number): Energy Future edition: 2026 (default), 2023 or 2021. Example: `2026`
- `limit` (number): Rows per page. Example: `200`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `region` (string): Province, territory or `Canada`. Example: `<region>`
- `scenario` (string): Scenario name or part of it (`Canada Net-zero`, `Current Measures`, `Global Net-zero`). Example: `Canada Net-zero`
- `variable` (string): Variable or part of it (`Brent`, `In Situ Bitumen`, `Electricity`). Example: `<variable>`
- `year_from` (number): year_from Example: `1990`
- `year_to` (number): year_to Example: `1990`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "cer-rec-gc-ca",
    capability: "energy-data/energy_future",
    options: {
      dataset: "benchmark_prices",
      edition: 2023,
      scenario: "Canada Net-zero",
      variable: "Brent",
      year_from: 2030,
      year_to: 2032,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "cer-rec-gc-ca",
  "capability": "energy-data/energy_future",
  "options": {
    "dataset": "benchmark_prices",
    "edition": 2023,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "cer-rec-gc-ca",
    "capability": "energy-data/energy_future",
    "options": {
      "dataset": "benchmark_prices",
      "edition": 2023,
      "scenario": "Canada Net-zero",
      "variable": "Brent",
      "year_from": 2030,
      "year_to": 2032
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'cer-rec-gc-ca/energy-data/energy_future' \
  --options '{"dataset":"benchmark_prices","edition":2023,"scenario":"Canada Net-zero","variable":"Brent","year_from":2030,"year_to":2032}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "cer-rec-gc-ca",
  "capability": "energy-data/energy_future",
  "options": {
    "dataset": "benchmark_prices",
    "edition": 2023,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "cer-rec-gc-ca",
  "capability": "energy-data/energy_future",
  "options": {
    "dataset": "benchmark_prices",
    "edition": 2023,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "categories": [],
  "dataset": "benchmark_prices",
  "edition": 2023,
  "filters": {
    "category": null,
    "region": null,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  },
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 200,
  "next_offset": null,
  "observed_at_ms": 1792969574133,
  "offset": 0,
  "regions": [],
  "report_url": "https://www.cer-rec.gc.ca/en/data-analysis/canada-energy-future/2023/",
  "rows": [
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 64,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2030
    },
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 63.8,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2031
    },
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 63.6,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2032
    }
  ],
  "scenarios": [
    "Current Measures",
    "Canada Net-zero",
    "Global Net-zero"
  ],
  "source": {
    "last_modified": "Fri, 09 Jun 2023 22:36:09 GMT",
    "url": "https://www.cer-rec.gc.ca/open/energy/energyfutures2023/benchmark-prices-2023.csv"
  },
  "total_count": 3,
  "units": [],
  "variables": [
    "Brent - 2022 US$/bbl",
    "Canadian Light Sweet (CLS) - 2022 US$/bbl",
    "Henry Hub - 2022 US$/MMBtu",
    "Nova Inventory Transfer (NIT) - 2022 US$/MMBtu",
    "West Texas Intermediate (WTI) - 2022 US$/bbl",
    "Western Canadian Select (WCS) - 2022 US$/bbl"
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Energy future

- Capability: `energy-data/energy_future`
- Description: Projections from Canada's Energy Future, the CER's long-term energy supply and demand outlook to 2050, read from the edition's open data (2026, 2023 or 2021): benchmark oil and gas prices, crude oil, natural gas, NGL and hydrogen production, electricity capacity, generation and interchange, end-use demand and prices by sector, primary demand, greenhouse gas emissions, macro indicators and gas drilling, by scenario (e.g. Canada Net-zero, Current Measures), region and year. Filter by scenario, region, variable, sector or type and years; each answer lists the dataset's scenarios, regions, variables, categories and units to refine with.
- Instructions: Questions like "CER 2026 projection of Alberta in situ bitumen output in 2035", "Brent price assumption in the Canada Net-zero scenario", "electricity generation by fuel in Ontario to 2050".
- Cost: 5 credits per call
- Capability file: [Energy future](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/energy_future)

Accepted options:
- `category` (string): Sector (`Residential`, `Transportation`) or type (`Primary Fuel`, `Supply`). Example: `<category>`
- `dataset` (string, required): Dataset (2021 lacks the two technology views and greenhouse gas emissions). Example: `benchmark_prices`
- `edition` (number): Energy Future edition: 2026 (default), 2023 or 2021. Example: `2026`
- `limit` (number): Rows per page. Example: `200`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `region` (string): Province, territory or `Canada`. Example: `<region>`
- `scenario` (string): Scenario name or part of it (`Canada Net-zero`, `Current Measures`, `Global Net-zero`). Example: `Canada Net-zero`
- `variable` (string): Variable or part of it (`Brent`, `In Situ Bitumen`, `Electricity`). Example: `<variable>`
- `year_from` (number): year_from Example: `1990`
- `year_to` (number): year_to Example: `1990`

Response schema example:
```json
{
  "categories": [],
  "dataset": "benchmark_prices",
  "edition": 2023,
  "filters": {
    "category": null,
    "region": null,
    "scenario": "Canada Net-zero",
    "variable": "Brent",
    "year_from": 2030,
    "year_to": 2032
  },
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 200,
  "next_offset": null,
  "observed_at_ms": 1792969574133,
  "offset": 0,
  "regions": [],
  "report_url": "https://www.cer-rec.gc.ca/en/data-analysis/canada-energy-future/2023/",
  "rows": [
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 64,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2030
    },
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 63.8,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2031
    },
    {
      "category": null,
      "region": null,
      "scenario": "Canada Net-zero",
      "unit": null,
      "value": 63.6,
      "variable": "Brent - 2022 US$/bbl",
      "year": 2032
    }
  ],
  "scenarios": [
    "Current Measures",
    "Canada Net-zero",
    "Global Net-zero"
  ],
  "source": {
    "last_modified": "Fri, 09 Jun 2023 22:36:09 GMT",
    "url": "https://www.cer-rec.gc.ca/open/energy/energyfutures2023/benchmark-prices-2023.csv"
  },
  "total_count": 3,
  "units": [],
  "variables": [
    "Brent - 2022 US$/bbl",
    "Canadian Light Sweet (CLS) - 2022 US$/bbl",
    "Henry Hub - 2022 US$/MMBtu",
    "Nova Inventory Transfer (NIT) - 2022 US$/MMBtu",
    "West Texas Intermediate (WTI) - 2022 US$/bbl",
    "Western Canadian Select (WCS) - 2022 US$/bbl"
  ]
}
```

### Energy statistics

- Capability: `energy-data/energy_statistics`
- Description: The CER's energy market and commodity statistics as open data: crude oil exports by US PADD, natural gas exports by port with values and prices, LNG exports by terminal and cargo, NGL and refined product exports, electricity exports and imports by province and US state with prices, estimated crude oil and marketable gas production by province, refinery crude runs, generating capacity and oil pipeline apportionment, monthly, weekly or annual. Filter any column by value (`filters`) and by period; newest first, paged. Each answer names the columns and lists the values of the categorical ones.
- Instructions: Questions like "Canadian crude exports to PADD II in 2024", "Quebec electricity exports to New York last month and the price", "Alberta crude production by type", "LNG cargoes from Canada".
- Cost: 5 credits per call
- Capability file: [Energy statistics](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/energy_statistics)

Accepted options:
- `dataset` (string, required): Statistics dataset. Example: `crude_oil_exports_monthly`
- `filters` (object): Column name (as listed in `columns`, case-insensitive) to the value wanted, e.g. `{"PADD": "PADD II"}`, `{"Activity": "Exports", "Source": "Quebec"}`. An exact value (accents ignored) is preferred, otherwise every value containing it. Example: `{}`
- `from` (string): Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<from>`
- `limit` (number): Rows per page. Example: `100`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `to` (string): Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<to>`

Response schema example:
```json
{
  "columns": [
    "Year",
    "PADD",
    "Volume (m3/d)",
    "Volume (bbl/d)"
  ],
  "dataset": "crude_oil_exports_annual",
  "facets": {
    "PADD": [
      "PADD I",
      "PADD II",
      "PADD III",
      "PADD IV",
      "PADD V",
      "Other",
      "Total"
    ]
  },
  "filters": {
    "PADD": "PADD II"
  },
  "frequency": "annual",
  "latest_period": "2025",
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 100,
  "next_offset": null,
  "observed_at_ms": 1792969574194,
  "offset": 0,
  "period_column": "Year",
  "rows": [
    {
      "period": "2020",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 2147730.2,
        "Volume (m3/d)": 341296.5
      }
    },
    {
      "period": "2019",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 2149728.1,
        "Volume (m3/d)": 341614
      }
    },
    {
      "period": "2018",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 2110391.5,
        "Volume (m3/d)": 335363
      }
    },
    {
      "period": "2017",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 2095034.9,
        "Volume (m3/d)": 332922.7
      }
    },
    {
      "period": "2016",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 1983510.4,
        "Volume (m3/d)": 315200.3
      }
    },
    {
      "period": "2015",
      "values": {
        "PADD": "PADD II",
        "Volume (bbl/d)": 1923540.1,
        "Volume (m3/d)": 305670.4
      }
    }
  ],
  "source": {
    "last_modified": "Thu, 01 Oct 2026 10:02:31 GMT",
    "url": "https://www.cer-rec.gc.ca/open/imports-exports/crude-oil-exports-by-destination-annual.csv"
  },
  "title": "Crude oil exports by destination (US PADD), annual",
  "total_count": 6,
  "window": {
    "from": "2015-01-01",
    "to": "2020-12-31"
  }
}
```

### Incidents

- Capability: `energy-data/incidents`
- Description: Incidents reported to the CER at federally regulated pipelines and facilities since 2008, from the CER's comprehensive incident open data (about 2,000 incidents): number, types (release of substance, fire, explosion, serious injury, operation beyond design limits...), reported, occurrence and closed dates, company, province, nearest town and coordinates, substance and volume released, significance, what and why it happened, pipeline or facility, injuries, fatalities and evacuations, emergency level and investigation type. Look one up by incident number or filter by company, province, substance, type, significance, status, words and reported date; newest first, paged, with totals by year.
- Instructions: Questions like "significant Trans Mountain incidents since 2024", "what happened in INC2023-155", "how many gas releases in Alberta in 2025".
- Cost: 5 credits per call
- Capability file: [Incidents](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/incidents)

Accepted options:
- `company` (string): Company or part of its name (`Trans Mountain`, `NOVA Gas`). Example: `Trans Mountain`
- `from` (string): Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<from>`
- `incident_number` (string): CER incident number, e.g. `INC2023-155`. Pattern: ^[Ii][Nn][Cc]\d{4}-\d{2,4}$. Example: `INC2023-155`
- `incident_type` (string): `Release of Substance`, `Fire`, `Explosion`, `Serious Injury`, `Fatality`, `Operation Beyond Design Limits`... or part of it. Example: `Release of Substance`
- `limit` (number): Rows per page. Example: `25`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `province` (string): province Example: `<province>`
- `query` (string): Words that must all appear in what or why it happened, nearest town, pipeline or facility name. Example: `<query>`
- `significant` (boolean): Only incidents the CER flags significant (true) or not (false). Example: `false`
- `status` (string): status Example: `<status>`
- `substance` (string): `Natural Gas - Sweet`, `Crude Oil`, `Propane`... or part of it. Example: `Natural Gas - Sweet`
- `to` (string): Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<to>`

Response schema example:
```json
{
  "data_dictionary_url": "https://www.cer-rec.gc.ca/open/incident/pipeline-incidents-data-dictionary.csv",
  "filters": {
    "company": null,
    "incident_number": "INC2023-155",
    "incident_type": null,
    "province": null,
    "query": null,
    "significant": null,
    "status": null,
    "substance": null
  },
  "incidents": [
    {
      "activity_at_time_of_incident": "Construction",
      "approximate_volume_released_m3": null,
      "closed_date": "2024-02-09",
      "company": "Trans Mountain Pipeline ULC",
      "discovered_date_time": "2023/09/09 01:30:00 PM Pacific",
      "emergency_level": "Not Emergency",
      "evacuated": 0,
      "facility_name": null,
      "facility_type": "Meter",
      "fatalities": null,
      "how_discovered": "Employee / Contractor (Onsite)",
      "incident_number": "INC2023-155",
      "incident_types": [
        "Adverse Environmental Effects"
      ],
      "injured": null,
      "investigation_type": "Inactive Investigation Level in Error",
      "latitude": 49.1968613,
      "longitude": -122.7469638,
      "nearest_populated_centre": "Surrey",
      "occurrence_date_time": "2023/09/09 01:30:00 PM Pacific",
      "pipeline_name": "TRANS MOUNTAIN EXPANSION PROJECT",
      "pipeline_or_facility_type": "Transmission",
      "province": "British Columbia",
      "regulation": null,
      "release_type": "Not Applicable",
      "reported_date": "2023-09-09",
      "residual_environmental_effects": "No",
      "rupture": "No",
      "significant": true,
      "status": "Closed",
      "substance": "Not Applicable",
      "volume_note": "Not Applicable",
      "what_happened": "Substandard Acts, Failure to identify hazard or risk",
      "what_happened_category": "Incorrect Operation",
      "why_it_happened": "Job or system factors, Inadequate engineering, Inadequate assessment of loss exposures",
      "why_it_happened_category": "Engineering and Planning"
    }
  ],
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 25,
  "next_offset": null,
  "observed_at_ms": 1792969573044,
  "offset": 0,
  "source": {
    "last_modified": "Thu, 01 Oct 2026 10:10:51 GMT",
    "url": "https://www.cer-rec.gc.ca/open/incident/pipeline-incidents-comprehensive-data.csv"
  },
  "summary": {
    "approximate_volume_released_m3": 0,
    "by_year": [
      {
        "count": 1,
        "year": "2023"
      }
    ],
    "significant": 1,
    "total": 1
  },
  "total_count": 1,
  "window": {
    "from": null,
    "to": null
  }
}
```

### Pipelines

- Capability: `energy-data/pipelines`
- Description: Key facts on the major CER-regulated oil and gas pipelines from the CER's Pipeline Profiles open data: operator and parent company, route, length, commodity, capacity, start year, interconnections, financial regulation group, links to the REGDOCS facility and toll folders and the Pipeline Profile page, and which systems have throughput and toll data here. Naming one pipeline (or company) also returns its annual financial series: revenue, cost of service, net income, rate base, return on equity and more.
- Instructions: Start here for "who operates Trans Mountain, how long is it and what is its capacity", "NGTL revenue and rate base", or to find the slug `throughput` and `tolls` take.
- Cost: 5 credits per call
- Capability file: [Pipelines](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/pipelines)

Accepted options:
- `pipeline` (string): A pipeline or company name or slug (`Trans Mountain`, `NGTL`, `Enbridge`, `keystone`). Omit to list all profiled pipelines. Example: `Trans Mountain`

Response schema example:
```json
{
  "count": 1,
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "observed_at_ms": 1792969568642,
  "open_data_url": "https://www.cer-rec.gc.ca/open/energy/",
  "pipelines": [
    {
      "capacity": "The Trans Mountain Expanded System has a nameplate capacity of approximately 890 thousand barrels per day (Mb/d). The Trans Mountain Expansion Project came online on 1 May 2024. Prior to that date, Trans Mountain’s nameplate capacity was approximately 300 Mb/d.",
      "commenced_operations": "1953",
      "commodity": "Crude oil and refined petroleum products",
      "company": "Trans Mountain Pipeline ULC",
      "facility_documents_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/548311",
      "financial_regulation_group": "Group 1",
      "financials": [
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2025",
          "value": 2878.2,
          "year": 2025
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2025",
          "value": 2878.2,
          "year": 2025
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2025",
          "value": 1279,
          "year": 2025
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2025",
          "value": 34271.699,
          "year": 2025
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2025",
          "value": 45,
          "year": 2025
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2025",
          "value": 5.74,
          "year": 2025
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2024",
          "value": 1754.8,
          "year": 2024
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2024",
          "value": null,
          "year": 2024
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2024",
          "value": 718,
          "year": 2024
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2024",
          "value": 35138.5,
          "year": 2024
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2024",
          "value": 45,
          "year": 2024
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2024",
          "value": 3.14,
          "year": 2024
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2023",
          "value": 416.6,
          "year": 2023
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2023",
          "value": 389.4,
          "year": 2023
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2023",
          "value": 55.3,
          "year": 2023
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2023",
          "value": 1053.3,
          "year": 2023
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2023",
          "value": 45,
          "year": 2023
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2023",
          "value": 11.67,
          "year": 2023
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2022",
          "value": 382.4,
          "year": 2022
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2022",
          "value": 382.8,
          "year": 2022
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2022",
          "value": 56.3,
          "year": 2022
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2022",
          "value": 1032.5,
          "year": 2022
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2022",
          "value": 45,
          "year": 2022
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2022",
          "value": 12.13,
          "year": 2022
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2021",
          "value": 342.2,
          "year": 2021
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2021",
          "value": 326.6,
          "year": 2021
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2021",
          "value": 47,
          "year": 2021
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2021",
          "value": 998.5,
          "year": 2021
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2021",
          "value": 45,
          "year": 2021
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2021",
          "value": 10.46,
          "year": 2021
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2020",
          "value": 317.9,
          "year": 2020
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2020",
          "value": 293.2,
          "year": 2020
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2020",
          "value": 44.4,
          "year": 2020
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2020",
          "value": 980.5,
          "year": 2020
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2020",
          "value": 45,
          "year": 2020
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2020",
          "value": 10.07,
          "year": 2020
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2019",
          "value": 321.5,
          "year": 2019
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2019",
          "value": 326.9,
          "year": 2019
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2019",
          "value": 38.4,
          "year": 2019
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2019",
          "value": 965.1,
          "year": 2019
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2019",
          "value": 45,
          "year": 2019
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2019",
          "value": 8.84,
          "year": 2019
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2018",
          "value": 294.8,
          "year": 2018
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2018",
          "value": 283.5,
          "year": 2018
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2018",
          "value": 47.3,
          "year": 2018
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2018",
          "value": 970.5,
          "year": 2018
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2018",
          "value": 45,
          "year": 2018
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2018",
          "value": 10.83,
          "year": 2018
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2017",
          "value": 287.4,
          "year": 2017
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2017",
          "value": 287.2,
          "year": 2017
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2017",
          "value": 42.9,
          "year": 2017
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2017",
          "value": 984.6,
          "year": 2017
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2017",
          "value": 45,
          "year": 2017
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2017",
          "value": 9.69,
          "year": 2017
        },
        {
          "measure": "Revenue (million $)",
          "period": "Jan - Dec 2016",
          "value": 286,
          "year": 2016
        },
        {
          "measure": "Revenue requirement (million $)",
          "period": "Jan - Dec 2016",
          "value": 269.8,
          "year": 2016
        },
        {
          "measure": "Net income (million $)",
          "period": "Jan - Dec 2016",
          "value": 47.1,
          "year": 2016
        },
        {
          "measure": "Average rate base (million $)",
          "period": "Jan - Dec 2016",
          "value": 1004.7,
          "year": 2016
        },
        {
          "measure": "Deemed equity ratio (%)",
          "period": "Jan - Dec 2016",
          "value": 45,
          "year": 2016
        },
        {
          "measure": "ROE (%)",
          "period": "Jan - Dec 2016",
          "value": 10.43,
          "year": 2016
        }
      ],
      "has_throughput_data": true,
      "has_toll_data": true,
      "interconnected_pipelines": "Puget Sound pipeline",
      "length_km": 1492,
      "location": "The Trans Mountain pipeline extends from Edmonton, Alberta to Burnaby, British Columbia, with delivery points in Kamloops, Sumas, and Burnaby, B.C.",
      "map_url": "https://www.transmountain.com/pipeline-system",
      "name": "Trans Mountain pipeline",
      "parent_company": "Trans Mountain Corporation",
      "profile_url": "https://apps.cer-rec.gc.ca/PPS/en/pipeline-profiles/trans-mountain-expanded-system",
      "slug": "trans-mountain",
      "toll_documents_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/552980",
      "website": "https://www.transmountain.com/"
    }
  ],
  "query": {
    "pipeline": "Trans Mountain"
  },
  "sources": [
    {
      "last_modified": "Fri, 23 Jan 2026 16:50:27 GMT",
      "url": "https://www.cer-rec.gc.ca/open/energy/pipeline-attributes.csv"
    },
    {
      "last_modified": "Wed, 27 May 2026 21:15:17 GMT",
      "url": "https://www.cer-rec.gc.ca/open/energy/pipeline-financials.csv"
    }
  ]
}
```

### Regulatory instruments

- Capability: `energy-data/regulatory_instruments`
- Description: Regulatory instruments the CER (and the NEB before it) issued, from the CER's Regulatory Instruments Report open data (about 17,000): certificates, orders, toll orders, export licences and permits, amending orders and decision letters, each with its file number, company, decision, issued, effective, expiry and sunset dates, Governor in Council and Order in Council approval, and the REGDOCS filing ids of the decision with search links. Look one up by instrument number or filter by type, company, file number, REGDOCS filing id or issued date; newest first, paged.
- Instructions: Questions like "which orders did the CER issue to Trans Mountain this year", "what is certificate GC-129 and its REGDOCS filing", "decisions on NGTL facilities in 2014".
- Cost: 5 credits per call
- Capability file: [Regulatory instruments](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/regulatory_instruments)

Accepted options:
- `company` (string): Company or part of its name. Example: `<company>`
- `file_number` (string): CER file number or part of it. Example: `<file_number>`
- `from` (string): Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<from>`
- `instrument_number` (string): Exact instrument number, e.g. `XG-N081-018-2014`, `TO-007-2026`. Example: `XG-N081-018-2014`
- `instrument_type` (string): Type prefix: `XG`, `XO`, `GC`, `OC`, `TO`, `TG`, `GL`, `EPE`, `MO`, `AO`, `LETTER`... Example: `<instrument_type>`
- `limit` (number): Rows per page. Example: `25`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `regdocs_number` (string): REGDOCS filing id, e.g. `C41016`. Example: `C41016`
- `to` (string): Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<to>`

Response schema example:
```json
{
  "filters": {
    "company": null,
    "file_number": null,
    "instrument_number": "XG-N081-018-2014",
    "instrument_type": null,
    "regdocs_number": null
  },
  "instruments": [
    {
      "board_decision_date": "2014-09-02",
      "board_item_identifier": "140902.2",
      "company": "NOVA Gas Transmission Ltd.",
      "effective_date": "2014-09-02",
      "expire_date": null,
      "file_number": "OF-Fac-Gas-N081-2014-09 01",
      "gic_approval_required": false,
      "instrument_number": "XG-N081-018-2014",
      "instrument_type": "XG",
      "issued_date": "2014-09-02",
      "minister_to_pco_date": null,
      "pco_approval_date": null,
      "pco_approval_number": null,
      "regdocs_numbers": [
        "A62616"
      ],
      "regdocs_search_urls": [
        "https://apps.cer-rec.gc.ca/REGDOCS/Search?txthl=A62616"
      ],
      "sent_to_minister_date": null,
      "sunset_date": "2015-09-02"
    }
  ],
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 25,
  "next_offset": null,
  "observed_at_ms": 1792969573546,
  "offset": 0,
  "source": {
    "last_modified": "Thu, 01 Oct 2026 09:00:20 GMT",
    "url": "https://www.cer-rec.gc.ca/open/application/regulatory-instruments.csv"
  },
  "total_count": 1,
  "window": {
    "from": null,
    "to": null
  }
}
```

### Throughput

- Capability: `energy-data/throughput`
- Description: Pipeline throughput and capacity at a CER-regulated system's key points, from the CER's Pipeline Throughput and Capacity open data (the numbers behind the Pipeline Profiles traffic charts): natural gas systems daily (returned as monthly averages unless `granularity` is `daily`), oil systems monthly by product. Each row has throughput and capacity in thousand m3/d, GJ/d for gas, committed and available capacity and the reason for variance for oil, and utilization. Filter by key point, product, trade type and date; newest first, paged. 19 systems: NGTL, TC Canadian Mainline, Westcoast, Alliance, Foothills, M&NP, TQM, Brunswick, Suffield, Trans Mountain, Enbridge Mainline, Line 9, Keystone, Cochin, Trans-Northern, Southern Lights, Norman Wells, Westspur and Montreal.
- Instructions: 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".
- Cost: 5 credits per call
- Capability file: [Throughput](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/throughput)

Accepted options:
- `from` (string): Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<from>`
- `granularity` (string): `monthly` (default; daily gas data averaged per month) or `daily` (gas systems only). Example: `monthly`
- `key_point` (string): Key point name or part of it (`Westridge`, `East Gate`, `Kerrobert`); see `key_points` in any answer. Example: `<key_point>`
- `limit` (number): Rows per page. Example: `100`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `pipeline` (string, required): 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. Example: `trans-mountain`
- `product` (string): Oil product class or part of it (`heavy`, `refined`). Example: `<product>`
- `to` (string): Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<to>`
- `trade_type` (string): `intracanada`, `export` or `import`. Example: `<trade_type>`

Response schema example:
```json
{
  "filters": {
    "key_point": "Westridge",
    "product": null,
    "trade_type": null
  },
  "granularity": "monthly",
  "key_points": [
    {
      "direction_of_flow": "west",
      "first_date": "2006-01-01",
      "last_date": "2026-06-01",
      "latitude": 49.2685,
      "longitude": -122.931,
      "name": "Burnaby",
      "trade_type": "intracanada"
    },
    {
      "direction_of_flow": "south",
      "first_date": "2006-01-01",
      "last_date": "2026-06-01",
      "latitude": 49.0766,
      "longitude": -122.203,
      "name": "Sumas",
      "trade_type": "export"
    },
    {
      "direction_of_flow": "west",
      "first_date": "2006-01-01",
      "last_date": "2026-06-01",
      "latitude": 49.2908,
      "longitude": -122.95,
      "name": "Westridge",
      "trade_type": "export"
    },
    {
      "direction_of_flow": null,
      "first_date": "2006-01-01",
      "last_date": "2026-06-01",
      "latitude": null,
      "longitude": null,
      "name": "system",
      "trade_type": null
    }
  ],
  "latest_date": "2026-06-01",
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 12,
  "next_offset": 12,
  "observed_at_ms": 1792969568689,
  "offset": 0,
  "pipeline": {
    "commodity": "oil and liquids",
    "name": "Trans Mountain pipeline",
    "slug": "trans-mountain"
  },
  "rows": [
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-12-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic heavy",
      "reason_for_variance": null,
      "throughput_1000m3d": 55.965,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-12-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic light",
      "reason_for_variance": null,
      "throughput_1000m3d": 11.661,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-12-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "refined petroleum products",
      "reason_for_variance": null,
      "throughput_1000m3d": 0,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-11-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic heavy",
      "reason_for_variance": null,
      "throughput_1000m3d": 80.337,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-11-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic light",
      "reason_for_variance": null,
      "throughput_1000m3d": 7.791,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-11-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "refined petroleum products",
      "reason_for_variance": null,
      "throughput_1000m3d": 0,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-10-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic heavy",
      "reason_for_variance": null,
      "throughput_1000m3d": 75.603,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-10-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic light",
      "reason_for_variance": null,
      "throughput_1000m3d": 9.534,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-10-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "refined petroleum products",
      "reason_for_variance": null,
      "throughput_1000m3d": 0,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-09-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic heavy",
      "reason_for_variance": null,
      "throughput_1000m3d": 61.556,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-09-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "domestic light",
      "reason_for_variance": null,
      "throughput_1000m3d": 14.896,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    },
    {
      "available_capacity_1000m3d": null,
      "capacity_1000m3d": null,
      "committed_1000m3d": null,
      "date": "2025-09-01",
      "days": null,
      "direction_of_flow": "west",
      "key_point": "Westridge",
      "product": "refined petroleum products",
      "reason_for_variance": null,
      "throughput_1000m3d": 0,
      "throughput_gj_d": null,
      "trade_type": "export",
      "uncommitted_1000m3d": null,
      "utilization_pct": null
    }
  ],
  "source": {
    "last_modified": "Thu, 27 Aug 2026 21:29:19 GMT",
    "url": "https://www.cer-rec.gc.ca/open/energy/throughput-capacity/trans-mountain-throughput-and-capacity.csv"
  },
  "total_count": 36,
  "window": {
    "from": "2025-01-01",
    "to": "2025-12-31"
  }
}
```

### Tolls

- Capability: `energy-data/tolls`
- Description: Tolls on a CER-regulated pipeline from the CER's Major Canadian Natural Gas and Oil Pipeline Tolls open data, collapsed from the CER's daily rows into effective periods: path, service, product, toll and unit, effective from and to, whether it is current, the tariff number it came from and replaced, and the REGDOCS folder and document ids of the tariff filing. Filter by path, service, product, current tolls only, or a date window; newest first, paged. Every answer also lists the system's paths, services and products. 25 systems, including Trans Mountain, Keystone, Enbridge Mainline, NGTL, TC Mainline, Westcoast, Alliance, Express and Cochin.
- Instructions: Questions like "current Trans Mountain toll Edmonton to Westridge for heavy crude", "NGTL firm receipt toll history", "which tariff set the Keystone toll and where is it in REGDOCS".
- Cost: 5 credits per call
- Capability file: [Tolls](https://firecrawl.dev/alexandria/agents/providers/cer-rec-gc-ca/energy-data/tolls)

Accepted options:
- `current_only` (boolean): Only tolls in force on the newest date in the file. Example: `false`
- `from` (string): Earliest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<from>`
- `limit` (number): Rows per page. Example: `50`
- `offset` (number): `next_offset` from the previous page; repeat the other inputs with it. Example: `0`
- `path` (string): Path or part of it (`Westridge`, `Receipt`). Example: `<path>`
- `pipeline` (string, required): 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 toll data. Example: `trans-mountain`
- `product` (string): Product or part of it (`heavy`, `light`). Example: `<product>`
- `service` (string): Service or part of it (`Firm`, `FT-D`). Example: `<service>`
- `to` (string): Latest date: `YYYY`, `YYYY-MM` or `YYYY-MM-DD` (a year or month means its last day). Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$. Example: `<to>`

Response schema example:
```json
{
  "filters": {
    "current_only": false,
    "path": null,
    "product": null,
    "service": null
  },
  "latest_date": "2026-06-01",
  "license": {
    "attribution": "Contains information licensed under the Open Government Licence - Canada (Canada Energy Regulator).",
    "name": "Open Government Licence - Canada 2.0",
    "url": "https://open.canada.ca/en/open-government-licence-canada"
  },
  "limit": 50,
  "next_offset": null,
  "observed_at_ms": 1792969570811,
  "offset": 0,
  "paths": [
    "Group 1",
    "Group 2",
    "Group 3",
    "Receipt"
  ],
  "pipeline": {
    "commodity": "natural gas",
    "name": "NGTL System",
    "slug": "ngtl"
  },
  "products": [
    "natural gas"
  ],
  "services": [
    "Average FT-D",
    "Average Firm Service Receipt"
  ],
  "source": {
    "last_modified": "Mon, 01 Jun 2026 16:33:34 GMT",
    "url": "https://www.cer-rec.gc.ca/open/tolls/ngtl-tolls.csv"
  },
  "tolls": [
    {
      "effective_from": "2024-01-01",
      "effective_to": "2024-12-31",
      "is_current": false,
      "path": "Group 1",
      "product": "natural gas",
      "regdocs_document_id": "4417207",
      "regdocs_document_url": "https://apps.cer-rec.gc.ca/REGDOCS/File/Download/4417207",
      "regdocs_folder_id": "4417206",
      "regdocs_folder_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/4417206",
      "replaces_tariff_number": null,
      "service": "Average FT-D",
      "tariff_number": null,
      "toll": 6.59,
      "unit": "$/GJ/mo"
    },
    {
      "effective_from": "2024-01-01",
      "effective_to": "2024-12-31",
      "is_current": false,
      "path": "Group 2",
      "product": "natural gas",
      "regdocs_document_id": "4417207",
      "regdocs_document_url": "https://apps.cer-rec.gc.ca/REGDOCS/File/Download/4417207",
      "regdocs_folder_id": "4417206",
      "regdocs_folder_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/4417206",
      "replaces_tariff_number": null,
      "service": "Average FT-D",
      "tariff_number": null,
      "toll": 9.11,
      "unit": "$/GJ/mo"
    },
    {
      "effective_from": "2024-01-01",
      "effective_to": "2024-12-31",
      "is_current": false,
      "path": "Group 3",
      "product": "natural gas",
      "regdocs_document_id": "4417207",
      "regdocs_document_url": "https://apps.cer-rec.gc.ca/REGDOCS/File/Download/4417207",
      "regdocs_folder_id": "4417206",
      "regdocs_folder_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/4417206",
      "replaces_tariff_number": null,
      "service": "Average FT-D",
      "tariff_number": null,
      "toll": 10.93,
      "unit": "$/GJ/mo"
    },
    {
      "effective_from": "2024-01-01",
      "effective_to": "2024-12-31",
      "is_current": false,
      "path": "Receipt",
      "product": "natural gas",
      "regdocs_document_id": "4417207",
      "regdocs_document_url": "https://apps.cer-rec.gc.ca/REGDOCS/File/Download/4417207",
      "regdocs_folder_id": "4417206",
      "regdocs_folder_url": "https://apps.cer-rec.gc.ca/REGDOCS/Item/View/4417206",
      "replaces_tariff_number": null,
      "service": "Average Firm Service Receipt",
      "tariff_number": null,
      "toll": 315.29,
      "unit": "$/103m3/mo"
    }
  ],
  "total_count": 4,
  "window": {
    "from": "2024-01-01",
    "to": "2024-12-31"
  }
}
```
