How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Department of Energy COAL API

Access to Coal Data

Department of Energy COAL API is one of 22 APIs that Department of Energy publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 67 operations across 54 paths, and defines 18 schemas. It is described by OpenAPI 3.0.0, at version 2.1.0.

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

67 operations 54 paths 18 schemas 54 GET13 POST

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

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

Paths & Operations 67

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

COAL 67

Access to Coal Data

GET
/v2/coal/aggregate-production/facet/{facet_id}
1 param → 400200
GET
/v2/coal/consumption-and-quality/facet/{facet_id}
1 param → 400200
GET
/v2/coal/exports-imports-quantity-price/facet/{facet_id}
1 param → 400200
GET
/v2/coal/market-sales-price/facet/{facet_id}
1 param → 400200
GET
/v2/coal/mine-production/facet/{facet_id}
1 param → 400200
GET
/v2/coal/price-by-rank/facet/{facet_id}
1 param → 400200
GET
/v2/coal/reserves-capacity/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/by-mine-by-plant/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/mine-aggregates/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/mine-state-aggregates/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/plant-aggregates/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/plant-state-aggregates/facet/{facet_id}
1 param → 400200
GET
/v2/coal/shipments/receipts/facet/{facet_id}
1 param → 400200
GET
/v2/coal/aggregate-production
→ 200
GET
/v2/coal/aggregate-production/facet
→ 400200
GET
/v2/coal/aggregate-production/data
API data with query params
8 params → 400200
POST
/v2/coal/aggregate-production/data
Return aggregate-production Data
body → 400200
GET
/v2/coal
Class CoalController
→ 200
GET
/v2/coal/consumption-and-quality
→ 200
GET
/v2/coal/consumption-and-quality/facet
→ 400200
GET
/v2/coal/consumption-and-quality/data
API data with query params
8 params → 400200
POST
/v2/coal/consumption-and-quality/data
Return consumption-and-quality Data
body → 400200
GET
/v2/coal/exports-imports-quantity-price
→ 200
GET
/v2/coal/exports-imports-quantity-price/facet
→ 400200
GET
/v2/coal/exports-imports-quantity-price/data
API data with query params
8 params → 400200
POST
/v2/coal/exports-imports-quantity-price/data
Return exports-imports-quantity-price Data
body → 400200
GET
/v2/coal/market-sales-price
→ 200
GET
/v2/coal/market-sales-price/facet
→ 400200
GET
/v2/coal/market-sales-price/data
API data with query params
8 params → 400200
POST
/v2/coal/market-sales-price/data
Return market-sales-price Data
body → 400200
GET
/v2/coal/mine-production
→ 200
GET
/v2/coal/mine-production/facet
→ 400200
GET
/v2/coal/mine-production/data
API data with query params
8 params → 400200
POST
/v2/coal/mine-production/data
Return mine-production Data
body → 400200
GET
/v2/coal/price-by-rank
→ 200
GET
/v2/coal/price-by-rank/facet
→ 400200
GET
/v2/coal/price-by-rank/data
API data with query params
8 params → 400200
POST
/v2/coal/price-by-rank/data
Return price-by-rank Data
body → 400200
GET
/v2/coal/reserves-capacity
→ 200
GET
/v2/coal/reserves-capacity/facet
→ 400200
GET
/v2/coal/reserves-capacity/data
API data with query params
8 params → 400200
POST
/v2/coal/reserves-capacity/data
Return reserves-capacity data
body → 400200
GET
/v2/coal/shipments/by-mine-by-plant
→ 200
GET
/v2/coal/shipments/by-mine-by-plant/facet
→ 400200
GET
/v2/coal/shipments/by-mine-by-plant/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/by-mine-by-plant/data
Return shipments by-mine-by-plant data
body → 400200
GET
/v2/coal/shipments/mine-aggregates
→ 200
GET
/v2/coal/shipments/mine-aggregates/facet
→ 400200
GET
/v2/coal/shipments/mine-aggregates/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/mine-aggregates/data
Return shipments mine-aggregates data
body → 400200
GET
/v2/coal/shipments/mine-state-aggregates
→ 200
GET
/v2/coal/shipments/mine-state-aggregates/facet
→ 400200
GET
/v2/coal/shipments/mine-state-aggregates/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/mine-state-aggregates/data
Return shipments mine-state-aggregates data
body → 400200
GET
/v2/coal/shipments/plant-aggregates
→ 200
GET
/v2/coal/shipments/plant-aggregates/facet
→ 400200
GET
/v2/coal/shipments/plant-aggregates/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/plant-aggregates/data
Return shipments plant-aggregates data
body → 400200
GET
/v2/coal/shipments/plant-state-aggregates
→ 200
GET
/v2/coal/shipments/plant-state-aggregates/facet
→ 400200
GET
/v2/coal/shipments/plant-state-aggregates/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/plant-state-aggregates/data
Return shipments plant-state-aggregates data
body → 400200
GET
/v2/coal/shipments/receipts
→ 200
GET
/v2/coal/shipments/receipts/facet
→ 400200
GET
/v2/coal/shipments/receipts/data
API data with query params
8 params → 400200
POST
/v2/coal/shipments/receipts/data
Return shipments receipts data
body → 400200
GET
/v2/coal/shipments
Class CoalController
→ 200

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are FinalRoute (10 properties), DataParams (8 properties), DataResponse (5 properties), Routes (4 properties). Each schema is shown below with its type and property counts.

FinalRoute
object
10 properties
Routes
object
4 properties
DataResponseContainer
object
3 properties
Facet
object
3 properties
FacetMetaData
object
2 properties
Frequency
object
4 properties
DataResponse
object
5 properties
FinalRouteResponseContainer
object
3 properties
FacetOptionListContainer
object
3 properties
Sort
object
2 properties
DataParams
object
8 properties
FinalRouteResponse
object
2 properties
FacetOptionList
object
2 properties
RouteResponseContainer
object
3 properties
RouteResponse
object
2 properties
RouteRequest
object
2 properties
FacetDetails
object
2 properties
FacetDetailsContainer
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

doe-coal-api-openapi.yml Raw ↑

Other APIs Department of Energy publishes across the network.

NLR Electricity APIs
NLR Solar Resource APIs
NLR Wind Resource APIs
NLR Transportation & Alternative Fuels APIs
NLR Buildings Energy APIs
DOE Data Explorer API
Department of Energy AEO API
Department of Energy CRUD_IMPORTS API
Department of Energy DBF API
Department of Energy ELEC API
Department of Energy EMISS API
Department of Energy IEO API
Where this information came from

This is an independent, third-party profile of Department of Energy COAL API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.