# EIA COAL API

**Canonical:** https://apis.io/apis/eia/eia-coal-api/  
**Provider:** EIA — https://apis.io/providers/eia/  
**Base URL:** https://api.eia.gov/v2  
**Documentation:** https://www.eia.gov/opendata/documentation.php

EIA COAL API is one of 17 APIs that [EIA](https://apis.io/providers/eia/) publishes on the [APIs.io](https://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, API documentation, an API reference, authentication docs, a getting-started guide, and rate-limit docs.

Access to Coal Data

## Operations (60 of 67)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/coal/aggregate-production/facet/{facet_id}` | — |
| GET | `/v2/coal/consumption-and-quality/facet/{facet_id}` | — |
| GET | `/v2/coal/exports-imports-quantity-price/facet/{facet_id}` | — |
| GET | `/v2/coal/market-sales-price/facet/{facet_id}` | — |
| GET | `/v2/coal/mine-production/facet/{facet_id}` | — |
| GET | `/v2/coal/price-by-rank/facet/{facet_id}` | — |
| GET | `/v2/coal/reserves-capacity/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/by-mine-by-plant/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/mine-aggregates/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/mine-state-aggregates/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/plant-aggregates/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/plant-state-aggregates/facet/{facet_id}` | — |
| GET | `/v2/coal/shipments/receipts/facet/{facet_id}` | — |
| GET | `/v2/coal/aggregate-production` | — |
| GET | `/v2/coal/aggregate-production/facet` | — |
| GET | `/v2/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 | `/v2/coal/consumption-and-quality/facet` | — |
| GET | `/v2/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 | `/v2/coal/exports-imports-quantity-price/facet` | — |
| GET | `/v2/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 | `/v2/coal/market-sales-price/facet` | — |
| GET | `/v2/coal/market-sales-price/data` | — |
| POST | `/v2/coal/market-sales-price/data` | Return market-sales-price Data |
| GET | `/v2/coal/mine-production` | — |
| GET | `/v2/coal/mine-production/facet` | — |
| GET | `/v2/coal/mine-production/data` | — |
| POST | `/v2/coal/mine-production/data` | Return mine-production Data |
| GET | `/v2/coal/price-by-rank` | — |
| GET | `/v2/coal/price-by-rank/facet` | — |
| GET | `/v2/coal/price-by-rank/data` | — |
| POST | `/v2/coal/price-by-rank/data` | Return price-by-rank Data |
| GET | `/v2/coal/reserves-capacity` | — |
| GET | `/v2/coal/reserves-capacity/facet` | — |
| GET | `/v2/coal/reserves-capacity/data` | — |
| POST | `/v2/coal/reserves-capacity/data` | Return reserves-capacity data |
| GET | `/v2/coal/shipments/by-mine-by-plant` | — |
| GET | `/v2/coal/shipments/by-mine-by-plant/facet` | — |
| GET | `/v2/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 | `/v2/coal/shipments/mine-aggregates/facet` | — |
| GET | `/v2/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 | `/v2/coal/shipments/mine-state-aggregates/facet` | — |
| GET | `/v2/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 | `/v2/coal/shipments/plant-aggregates/facet` | — |
| GET | `/v2/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 | `/v2/coal/shipments/plant-state-aggregates/facet` | — |

…and 7 more operations. They are listed in full on the page.

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/openapi/eia-coal-api-openapi.yml
- **Documentation** — https://www.eia.gov/opendata/documentation.php
- **APIReference** — https://www.eia.gov/opendata/browser/
- **Portal** — https://www.eia.gov/opendata/
- **SignUp** — https://www.eia.gov/opendata/register.php
- **Authentication** — https://www.eia.gov/opendata/register.php
- **TermsOfService** — https://www.eia.gov/opendata/register.php
- **Console** — https://www.eia.gov/opendata/browser/
- **Documentation** — https://www.eia.gov/opendata/qb.php
- **PrivacyPolicy** — https://www.eia.gov/about/privacy_security_policy.php
- **Examples** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/examples/eia-api-v2-examples.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/data-model/eia-data-model.yml
- **GettingStarted** — https://www.eia.gov/opendata/documentation.php
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/eia/refs/heads/main/rate-limits/eia-rate-limits.yml

## Other EIA APIs (12)

- [EIA Bulk Download Facility](https://apis.io/apis/eia/eia-bulk-download-facility/)
- [EIA AEO API](https://apis.io/apis/eia/eia-aeo-api/)
- [EIA CRUD IMPORTS API](https://apis.io/apis/eia/eia-crud-imports-api/)
- [EIA DBF API](https://apis.io/apis/eia/eia-dbf-api/)
- [EIA ELEC API](https://apis.io/apis/eia/eia-elec-api/)
- [EIA EMISS API](https://apis.io/apis/eia/eia-emiss-api/)
- [EIA IEO API](https://apis.io/apis/eia/eia-ieo-api/)
- [EIA INTL API](https://apis.io/apis/eia/eia-intl-api/)
- [EIA NG API](https://apis.io/apis/eia/eia-ng-api/)
- [EIA NUC STATUS API](https://apis.io/apis/eia/eia-nuc-status-api/)
- [EIA Root API](https://apis.io/apis/eia/eia-root-api/)
- [EIA RTO API](https://apis.io/apis/eia/eia-rto-api/)

## Tags

Coal

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/eia/eia-coal-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/eia/.