EIA

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