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 17 API contracts indexed on the APIs.io network, including AEO API, COAL API, CRUD IMPORTS API, and 14 more. Tagged areas include Energy, United States, Energy Markets, Electricity, and Natural Gas.
The EIA catalog on APIs.io includes 1 Spectral governance ruleset.
EIA’s developer surface includes authentication, developer portal, documentation, signup flow, developer console, tooling, API reference, and 38 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Energy & Utilities regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/eia/"><img src="https://apis.io/badge/eia/card.svg" alt="EIA on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Typed Event Surface+6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
Documented Reversibility+6 pts — a reversal operation in the contract, graded up when a window is documented too
5 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
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 ...
EIA publishes NO first-party MCP server, and no hosted/remote MCP endpoint exists onapi.eia.gov or www.eia.gov. What does exist is a real community MCP layer over APIv2:two inde...
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
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.
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: unknown
onboarding: unknown
trial: false
try_now: false
public: false
label: Unknown
confidence: low
source:
- authentication
- rate-limits
- security
generated: '2026-11-06'
method: derived
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-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
- aid: eia:eia-aeo-api
name: EIA AEO API
description: Access to Annual Energy Outlook Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- Answer Engine Optimization
tags_raw:
- AEO
properties:
- type: OpenAPI
url: openapi/eia-aeo-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-coal-api
name: EIA COAL API
description: Access to Coal Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- Coal
tags_raw:
- COAL
properties:
- type: OpenAPI
url: openapi/eia-coal-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-crud-imports-api
name: EIA CRUD IMPORTS API
description: Access to Crude Oil Imports Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- CRUD_IMPORTS
properties:
- type: OpenAPI
url: openapi/eia-crud-imports-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-dbf-api
name: EIA DBF API
description: Access to Densified Biomass Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- DBF
properties:
- type: OpenAPI
url: openapi/eia-dbf-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-elec-api
name: EIA ELEC API
description: Access to Electricity Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- ELEC
properties:
- type: OpenAPI
url: openapi/eia-elec-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-emiss-api
name: EIA EMISS API
description: Access to CO2 Emissions Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- EMISS
properties:
- type: OpenAPI
url: openapi/eia-emiss-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-ieo-api
name: EIA IEO API
description: Access to International Energy Outlook Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- IEO
properties:
- type: OpenAPI
url: openapi/eia-ieo-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-intl-api
name: EIA INTL API
description: Access to International Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- INTL
properties:
- type: OpenAPI
url: openapi/eia-intl-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-ng-api
name: EIA NG API
description: Access to Natural Gas Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- NG
properties:
- type: OpenAPI
url: openapi/eia-ng-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-nuc-status-api
name: EIA NUC STATUS API
description: Access to Nuclear Outages Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- NUC_STATUS
properties:
- type: OpenAPI
url: openapi/eia-nuc-status-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-root-api
name: EIA Root API
description: Available EIA API Datasets
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- Root
properties:
- type: OpenAPI
url: openapi/eia-root-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-rto-api
name: EIA RTO API
description: Access to Daily Electricity Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- RTO
properties:
- type: OpenAPI
url: openapi/eia-rto-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-seds-api
name: EIA SEDS API
description: Access to State Energy Data Systems (SEDS) Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- SEDS
properties:
- type: OpenAPI
url: openapi/eia-seds-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-sep-api
name: EIA SEP API
description: Access to State Electricity Profiles
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- SEP
properties:
- type: OpenAPI
url: openapi/eia-sep-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-steo-api
name: EIA STEO API
description: Access to Short Term Energy Outlook Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- STEO
properties:
- type: OpenAPI
url: openapi/eia-steo-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
- aid: eia:eia-total-api
name: EIA TOTAL API
description: Access to Total Energy Data
humanURL: https://www.eia.gov/opendata/documentation.php
baseURL: https://api.eia.gov/v2
tags:
- TOTAL
properties:
- type: OpenAPI
url: openapi/eia-total-api-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: Examples
url: examples/eia-api-v2-examples.yml
- type: DataModel
url: data-model/eia-data-model.yml
- type: GettingStarted
url: https://www.eia.gov/opendata/documentation.php
- type: RateLimits
url: rate-limits/eia-rate-limits.yml
common:
- type: CapabilityMap
url: capabilities/eia-capability-edges.yml
name: EIA Business Capability Map
- 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
EIA API — frequently asked questions
Does EIA have an API?
Yes. APIs.io lists 17 APIs from EIA, including EIA Bulk Download Facility, EIA AEO API and EIA COAL API, and 14 more.
Is there an OpenAPI specification for the EIA API?
Yes. APIs.io indexes 16 OpenAPI specifications for EIA, each linked for download from this page.
How do I authenticate with the EIA API?
EIA uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Eia Authentication.
Does EIA have an MCP server?
Yes. APIs.io lists 1 MCP server for EIA: EIA publishes NO first-party MCP server, and no hosted/remote MCP endpoint exists on
api.eia.gov or www.eia.gov. What does exist is a real community MCP layer over APIv2:
two independently maintained
Is the EIA API ready for AI agents?
EIA has a Kin Score of 49.8 out of 100 (developing) and an Agent Readiness score of 27.5 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.