Department of Energy

Department of Energy COAL API

Access to Coal Data

GitHub OpenAPI

Operations 67

GET /v2/coal/aggregate-production/facet/{facet_id} Get coal aggregate production facet by facet id #
GET /v2/coal/consumption-and-quality/facet/{facet_id} Get coal consumption and quality facet by facet id #
GET /v2/coal/exports-imports-quantity-price/facet/{facet_id} Get coal exports imports quantity price facet by facet id #
GET /v2/coal/market-sales-price/facet/{facet_id} Get coal market sales price facet by facet id #
GET /v2/coal/mine-production/facet/{facet_id} Get coal mine production facet by facet id #
GET /v2/coal/price-by-rank/facet/{facet_id} Get coal price by rank facet by facet id #
GET /v2/coal/reserves-capacity/facet/{facet_id} Get coal reserves capacity facet by facet id #
GET /v2/coal/shipments/by-mine-by-plant/facet/{facet_id} Get coal shipments by mine by plant facet by facet id #
GET /v2/coal/shipments/mine-aggregates/facet/{facet_id} Get coal shipments mine aggregates facet by facet id #
GET /v2/coal/shipments/mine-state-aggregates/facet/{facet_id} Get coal shipments mine state aggregates facet by facet id #
GET /v2/coal/shipments/plant-aggregates/facet/{facet_id} Get coal shipments plant aggregates facet by facet id #
GET /v2/coal/shipments/plant-state-aggregates/facet/{facet_id} Get coal shipments plant state aggregates facet by facet id #
GET /v2/coal/shipments/receipts/facet/{facet_id} Get coal shipments receipts facet by facet id #
GET /v2/coal/aggregate-production Get coal aggregate production #
GET /v2/coal/aggregate-production/facet Get coal aggregate production facet #
GET /v2/coal/aggregate-production/data Get coal aggregate production data #
POST /v2/coal/aggregate-production/data Return aggregate-production Data #
GET /v2/coal Class CoalController #
GET /v2/coal/consumption-and-quality Get coal consumption and quality #
GET /v2/coal/consumption-and-quality/facet Get coal consumption and quality facet #
GET /v2/coal/consumption-and-quality/data Get coal consumption and quality data #
POST /v2/coal/consumption-and-quality/data Return consumption-and-quality Data #
GET /v2/coal/exports-imports-quantity-price Get coal exports imports quantity price #
GET /v2/coal/exports-imports-quantity-price/facet Get coal exports imports quantity price facet #
GET /v2/coal/exports-imports-quantity-price/data Get coal exports imports quantity price data #
POST /v2/coal/exports-imports-quantity-price/data Return exports-imports-quantity-price Data #
GET /v2/coal/market-sales-price Get coal market sales price #
GET /v2/coal/market-sales-price/facet Get coal market sales price facet #
GET /v2/coal/market-sales-price/data Get coal market sales price data #
POST /v2/coal/market-sales-price/data Return market-sales-price Data #
GET /v2/coal/mine-production Get coal mine production #
GET /v2/coal/mine-production/facet Get coal mine production facet #
GET /v2/coal/mine-production/data Get coal mine production data #
POST /v2/coal/mine-production/data Return mine-production Data #
GET /v2/coal/price-by-rank Get coal price by rank #
GET /v2/coal/price-by-rank/facet Get coal price by rank facet #
GET /v2/coal/price-by-rank/data Get coal price by rank data #
POST /v2/coal/price-by-rank/data Return price-by-rank Data #
GET /v2/coal/reserves-capacity Get coal reserves capacity #
GET /v2/coal/reserves-capacity/facet Get coal reserves capacity facet #
GET /v2/coal/reserves-capacity/data Get coal reserves capacity data #
POST /v2/coal/reserves-capacity/data Return reserves-capacity data #
GET /v2/coal/shipments/by-mine-by-plant Get coal shipments by mine by plant #
GET /v2/coal/shipments/by-mine-by-plant/facet Get coal shipments by mine by plant facet #
GET /v2/coal/shipments/by-mine-by-plant/data Get coal shipments by mine by plant data #
POST /v2/coal/shipments/by-mine-by-plant/data Return shipments by-mine-by-plant data #
GET /v2/coal/shipments/mine-aggregates Get coal shipments mine aggregates #
GET /v2/coal/shipments/mine-aggregates/facet Get coal shipments mine aggregates facet #
GET /v2/coal/shipments/mine-aggregates/data Get coal shipments mine aggregates data #
POST /v2/coal/shipments/mine-aggregates/data Return shipments mine-aggregates data #
GET /v2/coal/shipments/mine-state-aggregates Get coal shipments mine state aggregates #
GET /v2/coal/shipments/mine-state-aggregates/facet Get coal shipments mine state aggregates facet #
GET /v2/coal/shipments/mine-state-aggregates/data Get coal shipments mine state aggregates data #
POST /v2/coal/shipments/mine-state-aggregates/data Return shipments mine-state-aggregates data #
GET /v2/coal/shipments/plant-aggregates Get coal shipments plant aggregates #
GET /v2/coal/shipments/plant-aggregates/facet Get coal shipments plant aggregates facet #
GET /v2/coal/shipments/plant-aggregates/data Get coal shipments plant aggregates data #
POST /v2/coal/shipments/plant-aggregates/data Return shipments plant-aggregates data #
GET /v2/coal/shipments/plant-state-aggregates Get coal shipments plant state aggregates #
GET /v2/coal/shipments/plant-state-aggregates/facet Get coal shipments plant state aggregates facet #
GET /v2/coal/shipments/plant-state-aggregates/data Get coal shipments plant state aggregates data #
POST /v2/coal/shipments/plant-state-aggregates/data Return shipments plant-state-aggregates data #
GET /v2/coal/shipments/receipts Get coal shipments receipts #
GET /v2/coal/shipments/receipts/facet Get coal shipments receipts facet #
GET /v2/coal/shipments/receipts/data Get coal shipments receipts data #
POST /v2/coal/shipments/receipts/data Return shipments receipts data #
GET /v2/coal/shipments Class CoalController #

Documentation

📖
Documentation
https://www.eia.gov/opendata/documentation.php
📖
Documentation
https://www.osti.gov/api/v1/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/doe/refs/heads/main/openapi/doe-coal-api-openapi.yml

Other Resources

🔗
Signup
https://www.eia.gov/opendata/register.php
🔗
TermsOfService
https://www.eia.gov/opendata/terms-of-service.php
🔗
FAQ
https://www.eia.gov/opendata/faqs.php

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doe-coal-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doe-coal-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: EIA APIv2 COAL API
  description: Swagger UI interface for EIA's APIv2. You can also explore EIA's API using the Opendata Query Browser. For this UI, you must use your EIA `api key` to apply filters and return data. You can register for an API Key at https://www.eia.gov/opendata/
  version: 2.1.0
servers:
- url: https://api.eia.gov
security:
- api_key: []
tags:


# --- truncated at 32 KB (46 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/doe/refs/heads/main/openapi/doe-coal-api-openapi.yml