EIA
The U.S. Energy Information Administration (EIA) is the independent statistical and analytical agency within the U.S. Department of Energy, created by the Department of Energy Organization Act of 1977, that collects, analyzes, and disseminates energy information for the United States. EIA sits at the measurement layer of the American energy value chain rather than the operating layer - it does not generate, transmit, distribute, or retail energy, and it does not regulate anyone. Instead it compels the industry to report through mandatory survey forms (EIA-860, EIA-861, EIA-923, EIA-176, EIA-914, EIA-930 and dozens more) and then publishes the result as the reference statistics for electricity, natural gas, petroleum, coal, nuclear, renewables, emissions, and international energy. EIA's API posture is the strongest of any organization in this sector and a genuine benchmark for government data anywhere. The Open Data APIv2 at api.eia.gov/v2 is a fully RESTful, self-documenting, hierarchically routed API covering more than two million time series, described by a real downloadable OpenAPI 3.0.0 contract carrying 225 paths and 278 operations, opened by a free API key that is emailed automatically from a public registration form with no review, no accreditation, and no licence to sign. A companion bulk download facility at api.eia.gov/bulk serves the same data as manifest-indexed zip archives and requires no key at all. The split that defines this sector is absolute here. EIA's market, system, and grid data is wide open - hourly balancing-authority demand and interchange, wholesale and spot prices, generator-level capacity and operations - while EIA publishes no consumer energy data API of any kind. There is no Green Button, no ESPI, no Download My Data, no Connect My Data, no consent flow, and no customer usage or billing endpoint, because individual customer data is never collected by EIA in the first place; its surveys arrive already aggregated from utilities and are further protected by statutory confidentiality. EIA is therefore the clearest instance of the recurring finding in this series - a federal data agency that publishes a far better documented, far more accessible API than the regulated utilities whose numbers it reports.
EIA publishes 1 API on the APIs.io network: Open Data API (APIv2). Tagged areas include Energy, United States, Energy Markets, Electricity, and Natural Gas.
EIA’s developer surface includes authentication, developer portal, documentation, signup flow, developer console, tooling, API reference, and 37 more developer resources.
2 APIs
1 MCP Servers
Individual APIs this provider publishes, each with its own machine-readable definition.
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Model Context Protocol servers that expose these APIs to AI agents.
Documented rate limits and quota policies.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Recommended x-agentic-access execution contracts for AI agents.
aid: eia
url: https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/apis.yml
name: EIA
kind: company
description: The U.S. Energy Information Administration (EIA) is the independent statistical and analytical agency within
the U.S. Department of Energy, created by the Department of Energy Organization Act of 1977, that collects, analyzes, and
disseminates energy information for the United States. EIA sits at the measurement layer of the American energy value chain
rather than the operating layer - it does not generate, transmit, distribute, or retail energy, and it does not regulate
anyone. Instead it compels the industry to report through mandatory survey forms (EIA-860, EIA-861, EIA-923, EIA-176, EIA-914,
EIA-930 and dozens more) and then publishes the result as the reference statistics for electricity, natural gas, petroleum,
coal, nuclear, renewables, emissions, and international energy. EIA's API posture is the strongest of any organization in
this sector and a genuine benchmark for government data anywhere. The Open Data APIv2 at api.eia.gov/v2 is a fully RESTful,
self-documenting, hierarchically routed API covering more than two million time series, described by a real downloadable
OpenAPI 3.0.0 contract carrying 225 paths and 278 operations, opened by a free API key that is emailed automatically from
a public registration form with no review, no accreditation, and no licence to sign. A companion bulk download facility
at api.eia.gov/bulk serves the same data as manifest-indexed zip archives and requires no key at all. The split that defines
this sector is absolute here. EIA's market, system, and grid data is wide open - hourly balancing-authority demand and interchange,
wholesale and spot prices, generator-level capacity and operations - while EIA publishes no consumer energy data API of
any kind. There is no Green Button, no ESPI, no Download My Data, no Connect My Data, no consent flow, and no customer usage
or billing endpoint, because individual customer data is never collected by EIA in the first place; its surveys arrive already
aggregated from utilities and are further protected by statutory confidentiality. EIA is therefore the clearest instance
of the recurring finding in this series - a federal data agency that publishes a far better documented, far more accessible
API than the regulated utilities whose numbers it reports.
image: https://www.eia.gov/global/images/logos/eia_logo_print.png
tags:
- Energy
- United States
- Energy Markets
- Electricity
- Natural Gas
- Petroleum
- Coal
- Nuclear
- Renewables
- Grid
- Emissions
- Government
- Open Data
- Energy Statistics
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: eia:eia-open-data-api-v2
name: EIA Open Data API (APIv2)
description: 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).
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- Open Data
- Electricity
- Natural Gas
- Petroleum
- Coal
- Nuclear
- Emissions
- Energy Statistics
- Time Series
properties:
- type: OpenAPI
url: openapi/eia-api-v2-openapi.yml
- type: Documentation
url: https://www.eia.gov/opendata/documentation.php
- type: APIReference
url: https://www.eia.gov/opendata/browser/
- type: Portal
url: https://www.eia.gov/opendata/
- type: SignUp
url: https://www.eia.gov/opendata/register.php
- type: Authentication
url: https://www.eia.gov/opendata/register.php
- type: TermsOfService
url: https://www.eia.gov/opendata/register.php
- type: Console
url: https://www.eia.gov/opendata/browser/
- type: Documentation
url: https://www.eia.gov/opendata/qb.php
- type: PrivacyPolicy
url: https://www.eia.gov/about/privacy_security_policy.php
- type: Overlay
url: overlays/eia-api-v2-overlay.yaml
- type: Examples
url: examples/eia-api-v2-examples.yml
name: Worked request/response examples from EIA technical documentation
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
name: API Technical Documentation - step-by-step guide from first call to paginated query
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
name: Published throttle guidance - ~9,000/hour sustained, 5/second burst
- aid: eia:eia-bulk-download-facility
name: EIA Bulk Download Facility
description: EIA's bulk data distribution surface, served from the same api.eia.gov host as APIv2 but requiring no API key
whatsoever. A single manifest at /bulk/manifest.txt returns a JSON catalog of every bulk dataset with Project Open Data
style metadata - identifier, title, description, keyword, publisher, person, mbox, accessLevel, accessURL, and last_updated
- and each dataset is then downloadable as a zip archive of newline-delimited JSON, for example /bulk/ELEC.zip. Datasets
include U.S. Electric System Operating Data (661,461 series), Electricity (285,080), Petroleum (53,464), Annual Energy
Outlook releases back to 2014, International, SEDS, STEO, Coal, Natural Gas, CO2 Emissions, Crude Oil Imports, Nuclear
Outages, and Total Energy. Updated twice daily at 5 a.m. and 3 p.m. Eastern. Verified live 2026-07-27 - GET /bulk/manifest.txt
returned HTTP 200 anonymously and GET /bulk/ELEC.zip returned HTTP 200 with a 291,920,911-byte zip payload, both without
a key.
humanURL: https://www.eia.gov/opendata/bulkfiles.php
baseURL: https://www.eia.gov/opendata/bulk
tags:
- Open Data
- Bulk Data
- Energy Statistics
- Electricity
- Time Series
properties:
- type: Documentation
url: https://www.eia.gov/opendata/bulkfiles.php
- type: DataCatalog
url: https://www.eia.gov/opendata/bulk/manifest.txt
name: Bulk manifest (api.eia.gov/bulk/manifest.txt now 301-redirects here)
- type: Portal
url: https://www.eia.gov/opendata/
- type: DataCatalog
url: https://www.eia.gov/opendata/bulk/manifest.txt
name: Bulk manifest - 29 datasets, Project Open Data style metadata, no API key required
- type: AgentSkill
url: skills/eia-bulk-download.md
name: Bulk-download EIA datasets without an API key
common:
- type: AgenticAccess
url: agentic-access/eia-agentic-access.yml
- type: DomainSecurity
url: security/eia-domain-security.yml
- type: Authentication
url: authentication/eia-authentication.yml
- type: Website
url: https://www.eia.gov
- type: Portal
url: https://www.eia.gov/opendata/
- type: Documentation
url: https://www.eia.gov/opendata/documentation.php
- type: SignUp
url: https://www.eia.gov/opendata/register.php
- type: Console
url: https://www.eia.gov/opendata/browser/
- type: PrivacyPolicy
url: https://www.eia.gov/about/privacy_security_policy.php
- type: GitHubOrganization
url: https://github.com/EIAgov
name: EIAgov - a GitHub USER account, not an organization; 4 public repos (NEMS, BlueSky, dash-benchmark, EIAgov). No API
client libraries or SDKs published.
- type: DataCatalog
url: https://www.energy.gov/data.json
name: DOE Project Open Data catalog - 342 of its 483 datasets are published by EIA
- type: Tools
url: https://www.eia.gov/tools/
- type: Documentation
url: https://www.eia.gov/opendata/excel/
name: EIA Excel Add-in - spreadsheet client for APIv2
- type: Documentation
url: https://www.eia.gov/electricity/gridmonitor/
name: Hourly Electric Grid Monitor - web tool over the /v2/electricity/rto routes
- type: Documentation
url: https://www.eia.gov/electricity/wholesalemarkets/
name: Wholesale Electricity Markets - link hub to the seven ISO/RTO data surfaces, not an EIA API
- type: Documentation
url: https://www.eia.gov/survey/
name: EIA survey forms - the mandatory industry reporting that feeds every API route
- type: DeveloperPortal
url: https://www.eia.gov/opendata/
- type: APIReference
url: https://www.eia.gov/opendata/browser/
name: Opendata Query Browser - point-and-click reference over every route
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
name: API Technical Documentation - guided walkthrough from first call to paginated query
- type: Support
url: https://www.eia.gov/opendata/faqs.php
name: Open Data FAQs; developer@eia.gov for key delivery issues
- type: HelpCenter
url: https://www.eia.gov/about/contact/
name: EIA Contact Us
- type: Blog
url: https://www.eia.gov/todayinenergy/
name: Today in Energy - EIA daily analysis series
- type: TermsOfService
url: https://www.eia.gov/opendata/register.php
name: API Terms of Service Agreement, published inline on the registration form
- type: Copyright
url: https://www.eia.gov/about/copyrights_reuse.php
name: Copyrights and Reuse Policy - attribution required, EIA logo not licensed
- type: Packages
url: packages/eia-packages.yml
name: No first-party SDK on any registry; community Python/R clients and the first-party Excel add-in
- type: WellKnown
url: well-known/eia-well-known.yml
name: Probe record - no /.well-known/ documents are served on either host
- type: MCPServer
url: mcp/eia-mcp.yml
name: No first-party MCP server; two community stdio servers over APIv2, plus a derived candidate tool set
- type: ToolCrosswalk
url: mcp/eia-tool-crosswalk.yml
name: MCP tools bound to backing OpenAPI operations
- type: LLMsTxt
url: llms/eia-llms.txt
- type: Overlay
url: overlays/eia-api-v2-overlay.yaml
name: API Evangelist enhancements over the published OpenAPI
- type: Conformance
url: conformance/eia-conformance.yml
- type: ErrorCatalog
url: errors/eia-problem-types.yml
- type: Lifecycle
url: lifecycle/eia-lifecycle.yml
- type: Deprecation
url: https://www.eia.gov/opendata/faqs.php
name: APIv1 deprecation and migration - communicated in the FAQ and technical documentation; EIA publishes no general deprecation
policy and no Sunset headers
- type: Conventions
url: conventions/eia-conventions.yml
- type: ChangeLog
url: https://www.eia.gov/opendata/documentation.php
name: APIv2 Patch Notes - dated release notes through v2.1.12 (March 2026)
- type: ChangeLog
url: changelog/eia-changelog.yml
name: Structured changelog, all 15 published releases
- type: Components
url: components/eia-components.yml
name: Embeddable chart widget, Excel/Sheets add-ins, hosted query browser
- type: DataModel
url: data-model/eia-data-model.yml
- type: Examples
url: examples/eia-api-v2-examples.yml
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- type: VulnerabilityDisclosure
url: security/eia-vulnerability-disclosure.yml
- type: Security
url: https://www.energy.gov/cio/articles/vulnerability-disclosure-policy
name: DOE Vulnerability Disclosure Program - DOE O 205.1D Attachment 2, linked from every eia.gov page footer
- type: AgentSkill
url: skills/_index.yml
name: Three generated agent skills grounded in verified APIv2 paths
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Kin Score
How this is scored →