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 36 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.2.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.2.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}
Get coal aggregate production facet by facet id
getV2CoalAggregateProductionFacetByFacetId 1 param → 400200
GET
/v2/coal/consumption-and-quality/facet/{facet_id}
Get coal consumption and quality facet by facet id
getV2CoalConsumptionAndQualityFacetByFacetId 1 param → 400200
GET
/v2/coal/exports-imports-quantity-price/facet/{facet_id}
Get coal exports imports quantity price facet by facet id
getV2CoalExportsImportsQuantityPriceFacetByFacetId 1 param → 400200
GET
/v2/coal/market-sales-price/facet/{facet_id}
Get coal market sales price facet by facet id
getV2CoalMarketSalesPriceFacetByFacetId 1 param → 400200
GET
/v2/coal/mine-production/facet/{facet_id}
Get coal mine production facet by facet id
getV2CoalMineProductionFacetByFacetId 1 param → 400200
GET
/v2/coal/price-by-rank/facet/{facet_id}
Get coal price by rank facet by facet id
getV2CoalPriceByRankFacetByFacetId 1 param → 400200
GET
/v2/coal/reserves-capacity/facet/{facet_id}
Get coal reserves capacity facet by facet id
getV2CoalReservesCapacityFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/by-mine-by-plant/facet/{facet_id}
Get coal shipments by mine by plant facet by facet id
getV2CoalShipmentsByMineByPlantFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/mine-aggregates/facet/{facet_id}
Get coal shipments mine aggregates facet by facet id
getV2CoalShipmentsMineAggregatesFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/mine-state-aggregates/facet/{facet_id}
Get coal shipments mine state aggregates facet by facet id
getV2CoalShipmentsMineStateAggregatesFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/plant-aggregates/facet/{facet_id}
Get coal shipments plant aggregates facet by facet id
getV2CoalShipmentsPlantAggregatesFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/plant-state-aggregates/facet/{facet_id}
Get coal shipments plant state aggregates facet by facet id
getV2CoalShipmentsPlantStateAggregatesFacetByFacetId 1 param → 400200
GET
/v2/coal/shipments/receipts/facet/{facet_id}
Get coal shipments receipts facet by facet id
getV2CoalShipmentsReceiptsFacetByFacetId 1 param → 400200
GET
/v2/coal/aggregate-production
Get coal aggregate production
getV2CoalAggregateProduction → 200
GET
/v2/coal/aggregate-production/facet
Get coal aggregate production facet
getV2CoalAggregateProductionFacet → 400200
GET
/v2/coal/aggregate-production/data
Get coal aggregate production data
getV2CoalAggregateProductionData 8 params → 400200
POST
/v2/coal/aggregate-production/data
Return aggregate-production Data
postV2CoalAggregateProductionData body → 400200
GET
/v2/coal
Class CoalController
getV2Coal → 200
GET
/v2/coal/consumption-and-quality
Get coal consumption and quality
getV2CoalConsumptionAndQuality → 200
GET
/v2/coal/consumption-and-quality/facet
Get coal consumption and quality facet
getV2CoalConsumptionAndQualityFacet → 400200
GET
/v2/coal/consumption-and-quality/data
Get coal consumption and quality data
getV2CoalConsumptionAndQualityData 8 params → 400200
POST
/v2/coal/consumption-and-quality/data
Return consumption-and-quality Data
postV2CoalConsumptionAndQualityData body → 400200
GET
/v2/coal/exports-imports-quantity-price
Get coal exports imports quantity price
getV2CoalExportsImportsQuantityPrice → 200
GET
/v2/coal/exports-imports-quantity-price/facet
Get coal exports imports quantity price facet
getV2CoalExportsImportsQuantityPriceFacet → 400200
GET
/v2/coal/exports-imports-quantity-price/data
Get coal exports imports quantity price data
getV2CoalExportsImportsQuantityPriceData 8 params → 400200
POST
/v2/coal/exports-imports-quantity-price/data
Return exports-imports-quantity-price Data
postV2CoalExportsImportsQuantityPriceData body → 400200
GET
/v2/coal/market-sales-price
Get coal market sales price
getV2CoalMarketSalesPrice → 200
GET
/v2/coal/market-sales-price/facet
Get coal market sales price facet
getV2CoalMarketSalesPriceFacet → 400200
GET
/v2/coal/market-sales-price/data
Get coal market sales price data
getV2CoalMarketSalesPriceData 8 params → 400200
POST
/v2/coal/market-sales-price/data
Return market-sales-price Data
postV2CoalMarketSalesPriceData body → 400200
GET
/v2/coal/mine-production
Get coal mine production
getV2CoalMineProduction → 200
GET
/v2/coal/mine-production/facet
Get coal mine production facet
getV2CoalMineProductionFacet → 400200
GET
/v2/coal/mine-production/data
Get coal mine production data
getV2CoalMineProductionData 8 params → 400200
POST
/v2/coal/mine-production/data
Return mine-production Data
postV2CoalMineProductionData body → 400200
GET
/v2/coal/price-by-rank
Get coal price by rank
getV2CoalPriceByRank → 200
GET
/v2/coal/price-by-rank/facet
Get coal price by rank facet
getV2CoalPriceByRankFacet → 400200
GET
/v2/coal/price-by-rank/data
Get coal price by rank data
getV2CoalPriceByRankData 8 params → 400200
POST
/v2/coal/price-by-rank/data
Return price-by-rank Data
postV2CoalPriceByRankData body → 400200
GET
/v2/coal/reserves-capacity
Get coal reserves capacity
getV2CoalReservesCapacity → 200
GET
/v2/coal/reserves-capacity/facet
Get coal reserves capacity facet
getV2CoalReservesCapacityFacet → 400200
GET
/v2/coal/reserves-capacity/data
Get coal reserves capacity data
getV2CoalReservesCapacityData 8 params → 400200
POST
/v2/coal/reserves-capacity/data
Return reserves-capacity data
postV2CoalReservesCapacityData body → 400200
GET
/v2/coal/shipments/by-mine-by-plant
Get coal shipments by mine by plant
getV2CoalShipmentsByMineByPlant → 200
GET
/v2/coal/shipments/by-mine-by-plant/facet
Get coal shipments by mine by plant facet
getV2CoalShipmentsByMineByPlantFacet → 400200
GET
/v2/coal/shipments/by-mine-by-plant/data
Get coal shipments by mine by plant data
getV2CoalShipmentsByMineByPlantData 8 params → 400200
POST
/v2/coal/shipments/by-mine-by-plant/data
Return shipments by-mine-by-plant data
postV2CoalShipmentsByMineByPlantData body → 400200
GET
/v2/coal/shipments/mine-aggregates
Get coal shipments mine aggregates
getV2CoalShipmentsMineAggregates → 200
GET
/v2/coal/shipments/mine-aggregates/facet
Get coal shipments mine aggregates facet
getV2CoalShipmentsMineAggregatesFacet → 400200
GET
/v2/coal/shipments/mine-aggregates/data
Get coal shipments mine aggregates data
getV2CoalShipmentsMineAggregatesData 8 params → 400200
POST
/v2/coal/shipments/mine-aggregates/data
Return shipments mine-aggregates data
postV2CoalShipmentsMineAggregatesData body → 400200
GET
/v2/coal/shipments/mine-state-aggregates
Get coal shipments mine state aggregates
getV2CoalShipmentsMineStateAggregates → 200
GET
/v2/coal/shipments/mine-state-aggregates/facet
Get coal shipments mine state aggregates facet
getV2CoalShipmentsMineStateAggregatesFacet → 400200
GET
/v2/coal/shipments/mine-state-aggregates/data
Get coal shipments mine state aggregates data
getV2CoalShipmentsMineStateAggregatesData 8 params → 400200
POST
/v2/coal/shipments/mine-state-aggregates/data
Return shipments mine-state-aggregates data
postV2CoalShipmentsMineStateAggregatesData body → 400200
GET
/v2/coal/shipments/plant-aggregates
Get coal shipments plant aggregates
getV2CoalShipmentsPlantAggregates → 200
GET
/v2/coal/shipments/plant-aggregates/facet
Get coal shipments plant aggregates facet
getV2CoalShipmentsPlantAggregatesFacet → 400200
GET
/v2/coal/shipments/plant-aggregates/data
Get coal shipments plant aggregates data
getV2CoalShipmentsPlantAggregatesData 8 params → 400200
POST
/v2/coal/shipments/plant-aggregates/data
Return shipments plant-aggregates data
postV2CoalShipmentsPlantAggregatesData body → 400200
GET
/v2/coal/shipments/plant-state-aggregates
Get coal shipments plant state aggregates
getV2CoalShipmentsPlantStateAggregates → 200
GET
/v2/coal/shipments/plant-state-aggregates/facet
Get coal shipments plant state aggregates facet
getV2CoalShipmentsPlantStateAggregatesFacet → 400200
GET
/v2/coal/shipments/plant-state-aggregates/data
Get coal shipments plant state aggregates data
getV2CoalShipmentsPlantStateAggregatesData 8 params → 400200
POST
/v2/coal/shipments/plant-state-aggregates/data
Return shipments plant-state-aggregates data
postV2CoalShipmentsPlantStateAggregatesData body → 400200
GET
/v2/coal/shipments/receipts
Get coal shipments receipts
getV2CoalShipmentsReceipts → 200
GET
/v2/coal/shipments/receipts/facet
Get coal shipments receipts facet
getV2CoalShipmentsReceiptsFacet → 400200
GET
/v2/coal/shipments/receipts/data
Get coal shipments receipts data
getV2CoalShipmentsReceiptsData 8 params → 400200
POST
/v2/coal/shipments/receipts/data
Return shipments receipts data
postV2CoalShipmentsReceiptsData body → 400200
GET
/v2/coal/shipments
Class CoalController
getV2CoalShipments → 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.

DataParams
object
8 properties
DataResponseContainer
object
3 properties
FacetDetailsContainer
object
3 properties
FacetMetaData
object
2 properties
RouteResponseContainer
object
3 properties
RouteResponse
object
2 properties
Facet
object
3 properties
Frequency
object
4 properties
FinalRouteResponse
object
2 properties
FacetOptionList
object
2 properties
FacetDetails
object
2 properties
FinalRouteResponseContainer
object
3 properties
DataResponse
object
5 properties
Sort
object
2 properties
RouteRequest
object
2 properties
Routes
object
4 properties
FinalRoute
object
10 properties
FacetOptionListContainer
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.