Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Energy Information Administration Discovery API

Browse the API tree to discover available routes, facets, and metadata.

Energy Information Administration Discovery API is one of 10 APIs that Energy Information Administration publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Discovery. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 7 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 2.1.

Requests are made against a single base URL, https://api.eia.gov/v2.

7 operations 7 paths 1 schemas 7 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.1
Base URL
https://api.eia.gov/v2
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Energy Information Administration Discovery API declares 1 security scheme for authenticating requests. An API key is passed in the query as api_key (apiKeyQuery). By default, every request must be authenticated.

  • apiKeyQuery — Free API key obtained at https://www.eia.gov/opendata/register.php. Must be supplied on every request as the apikey URL parameter.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.

Discovery 7

Browse the API tree to discover available routes, facets, and metadata.

GET
/
List top-level data categories
getRoot → 200
GET
/electricity
List electricity child routes
getElectricityRoutes → 200
GET
/natural-gas
List natural gas child routes
getNaturalGasRoutes → 200
GET
/petroleum
List petroleum child routes
getPetroleumRoutes → 200
GET
/coal
List coal child routes
getCoalRoutes → 200
GET
/nuclear-outages
List nuclear outage child routes
getNuclearOutagesRoutes → 200
GET
/international
List international child routes
getInternationalRoutes → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is RouteMetadata (3 properties). Each schema is shown below with its type and property counts.

RouteMetadata
object
Metadata about a route, including its child routes, facets, and frequencies.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

energy-information-administration-discovery-api-openapi.yml Raw ↑

Other APIs Energy Information Administration publishes across the network.

Energy Information Administration CO2 Emissions API
Energy Information Administration Coal API
Energy Information Administration Electricity API
Energy Information Administration International API
Energy Information Administration Natural Gas API
Energy Information Administration Nuclear API
Energy Information Administration Petroleum API
Energy Information Administration SEDS API
Energy Information Administration Total Energy API