Access to State Energy Data Systems (SEDS) Data
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/doe-seds-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: EIA APIv2 AEO SEDS API
description: Swagger UI interface for EIA's APIv2. You can also explore EIA's API using the [Opendata Query Browser](https://www.eia.gov/opendata/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/](https://www.eia.gov/opendata/)
version: 2.1.0
servers:
- url: https://api.eia.gov
security:
- api_key: []
tags:
- name: SEDS
description: Access to State Energy Data Systems (SEDS) Data
paths:
/v2/seds:
get:
tags:
- SEDS
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/responses/final-route'
/v2/seds/facet:
get:
tags:
- SEDS
responses:
'400':
description: Invalid input
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/responses/facets'
/v2/seds/facet/{facet_id}:
get:
tags:
- SEDS
parameters:
- name: facet_id
in: path
description: ''
required: true
schema:
type: string
responses:
'400':
description: Invalid input
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/responses/facet'
/v2/seds/data:
get:
tags:
- SEDS
description: API data with query params
parameters:
- $ref: '#/components/parameters/data'
- $ref: '#/components/parameters/facets'
- $ref: '#/components/parameters/frequency'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/length'
- $ref: '#/components/parameters/offset'
responses:
'400':
description: Invalid input
'404':
description: Not Found
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/responses/data'
post:
tags:
- SEDS
summary: Return SEDS Data
description: 'Class SEDSController
SEDS data set top-level controller.'
requestBody:
$ref: '#/components/requestBodies/dataParams'
responses:
'400':
description: Invalid input
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/responses/data'
components:
schemas:
DataResponseContainer:
properties:
apiVersion:
type: string
request:
$ref: '#/components/schemas/RouteRequest'
response:
$ref: '#/components/schemas/DataResponse'
type: object
FacetDetails:
properties:
totalFacets:
type: integer
facets:
type: array
items:
$ref: '#/components/schemas/Facet'
type: object
FacetDetailsContainer:
properties:
apiVersion:
type: string
request:
$ref: '#/components/schemas/RouteRequest'
response:
$ref: '#/components/schemas/FacetDetails'
type: object
Frequency:
properties:
id:
type: string
description:
type: string
format:
type: string
query:
type: string
type: object
DataParams:
properties:
data:
type: array
items:
type: string
facets:
type: object
frequency:
type: string
start:
type: string
end:
type: string
sort:
type: array
items:
$ref: '#/components/schemas/Sort'
length:
type: integer
offset:
type: integer
type: object
FacetOptionListContainer:
properties:
apiVersion:
type: string
request:
$ref: '#/components/schemas/RouteRequest'
response:
$ref: '#/components/schemas/FacetOptionList'
type: object
FinalRoute:
properties:
id:
type: string
name:
type: string
description:
type: string
frequency:
type: array
items:
$ref: '#/components/schemas/Frequency'
facets:
type: array
items:
$ref: '#/components/schemas/FacetMetaData'
data: {}
startPeriod:
type: string
endPeriod:
type: string
defaultDateFormat:
type: string
defaultFrequency:
type: string
type: object
DataResponse:
properties:
data: {}
dateFormat:
type: string
description:
type: string
frequency:
type: string
total:
type: integer
type: object
Sort:
properties:
column:
type: string
direction:
type: string
type: object
FacetMetaData:
properties:
id:
type: string
description:
type: string
type: object
FinalRouteResponseContainer:
properties:
apiVersion:
type: string
request:
$ref: '#/components/schemas/RouteRequest'
response:
$ref: '#/components/schemas/FinalRouteResponse'
type: object
FacetOptionList:
properties:
totalFacetOptions:
type: integer
facetOptions:
type: array
items:
type: string
type: object
Facet:
properties:
id:
type: string
name:
type: string
alias:
type: string
type: object
RouteRequest:
properties:
command:
type: array
items:
type: string
params: {}
type: object
FinalRouteResponse:
properties:
response:
$ref: '#/components/schemas/FinalRoute'
request:
$ref: '#/components/schemas/RouteRequest'
type: object
parameters:
end:
name: end
in: query
description: End date to filter by
required: false
schema:
type: string
facets:
name: facets
in: query
description: Facets to filter by
required: false
schema:
type: object
length:
name: length
in: query
description: Max length of returned data
required: false
schema:
type: integer
data:
name: data
in: query
description: Data columns to filter by
required: false
schema:
type: array
items:
type: string
offset:
name: offset
in: query
description: Offset of returned data
required: false
schema:
type: integer
start:
name: start
in: query
description: Start date to filter by
required: false
schema:
type: string
frequency:
name: frequency
in: query
description: Frequency to filter by
required: false
schema:
type: string
sort:
name: sort
in: query
description: How to sort returned data
required: false
schema:
$ref: '#/components/schemas/Sort'
responses:
facets:
description: List of facet options
content:
application/json:
schema:
$ref: '#/components/schemas/FacetOptionListContainer'
final-route:
description: List of API data sets
content:
application/json:
schema:
$ref: '#/components/schemas/FinalRouteResponseContainer'
facet:
description: Facet details
content:
application/json:
schema:
$ref: '#/components/schemas/FacetDetailsContainer'
data:
description: API Data
content:
application/json:
schema:
$ref: '#/components/schemas/DataResponseContainer'
requestBodies:
dataParams:
description: Parameters for data call
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DataParams'
securitySchemes:
api_key:
type: apiKey
name: api_key
in: query
externalDocs:
description: EIA's API Technical Documentation
url: https://www.eia.gov/opendata/documentation.php