# EIA Open Data API (APIv2)

**Canonical:** https://apis.io/apis/eia/eia-open-data-api-v2/  
**Provider:** EIA — https://apis.io/providers/eia/  
**Base URL:** https://api.eia.gov/v2  
**Documentation:** https://www.eia.gov/opendata/documentation.php

EIA Open Data API (APIv2) is one of 2 APIs that [EIA](https://apis.io/providers/eia/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Open Data, Electricity, Natural Gas, Petroleum, and Coal. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, and rate-limit docs.

EIA's public, fully RESTful open data API covering more than two million energy time series. Datasets are arranged in a discoverable tree - request a parent route such as /v2/electricity and the API returns its child routes, available frequencies, facets, and data columns as metadata; append /data to retrieve values, with facets, column selection, date range, sort, offset, and length all expressed as query parameters. Route families cover electricity (including hourly RTO and balancing-authority operating data), natural gas, petroleum, coal, nuclear outages, densified biomass, CO2 emissions, international energy, the State Energy Data System, state electricity profiles, and the Short-Term, Annual, and International Energy Outlook projections. Responses are JSON by default or XML with out=xml, capped at 5,000 rows per request with an explicit pagination warning returned in the payload. The legacy APIv1 series interface is deprecated but its identifiers remain reachable through the /v2/seriesid/{id} route. Verified live 2026-07-27 - an unauthenticated GET returns HTTP 403 with API_KEY_MISSING and a bogus key returns HTTP 403 with API_KEY_INVALID. Published API version at the time of review is 2.1.12 (March 2026).

## Machine-readable artifacts (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/openapi/eia-api-v2-openapi.yml
- **Documentation** — https://www.eia.gov/opendata/documentation.php
- **APIReference** — https://www.eia.gov/opendata/browser/
- **Portal** — https://www.eia.gov/opendata/
- **SignUp** — https://www.eia.gov/opendata/register.php
- **Authentication** — https://www.eia.gov/opendata/register.php
- **TermsOfService** — https://www.eia.gov/opendata/register.php
- **Console** — https://www.eia.gov/opendata/browser/
- **Documentation** — https://www.eia.gov/opendata/qb.php
- **PrivacyPolicy** — https://www.eia.gov/about/privacy_security_policy.php
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/overlays/eia-api-v2-overlay.yaml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/examples/eia-api-v2-examples.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/data-model/eia-data-model.yml
- **GettingStarted** — https://www.eia.gov/opendata/documentation.php
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/rate-limits/eia-rate-limits.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/apis.yml

## Other EIA APIs (1)

- [EIA Bulk Download Facility](https://apis.io/apis/eia/eia-bulk-download-facility/)

## Tags

Open Data, Electricity, Natural Gas, Petroleum, Coal, Nuclear, Emissions, Energy Statistics, Time Series

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/eia/eia-open-data-api-v2/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/eia/.