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 SEP API

Access to State Electricity Profiles

Department of Energy SEP 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 SEP. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 36 operations across 29 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.

36 operations 29 paths 18 schemas 29 GET7 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 SEP 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 36

Across 29 paths, the API surfaces 36 operations — 29 GET, 7 POST. Each is listed below with its method, path, parameters, and response codes.

SEP 36

Access to State Electricity Profiles

GET
/v2/electricity/state-electricity-profiles/capability/facet/{facet_id}
Get electricity state electricity profiles capability facet by facet id
getV2ElectricityStateElectricityProfilesCapabilityFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/facet/{facet_id}
Get electricity state electricity profiles emissions by state by fuel facet by…
getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/energy-efficiency/facet/{facet_id}
Get electricity state electricity profiles energy efficiency facet by facet id
getV2ElectricityStateElectricityProfilesEnergyEfficiencyFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/meters/facet/{facet_id}
Get electricity state electricity profiles meters facet by facet id
getV2ElectricityStateElectricityProfilesMetersFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/net-metering/facet/{facet_id}
Get electricity state electricity profiles net metering facet by facet id
getV2ElectricityStateElectricityProfilesNetMeteringFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/source-disposition/facet/{facet_id}
Get electricity state electricity profiles source disposition facet by facet id
getV2ElectricityStateElectricityProfilesSourceDispositionFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/summary/facet/{facet_id}
Get electricity state electricity profiles summary facet by facet id
getV2ElectricityStateElectricityProfilesSummaryFacetByFacetId 1 param → 400200
GET
/v2/electricity/state-electricity-profiles/capability
Get electricity state electricity profiles capability
getV2ElectricityStateElectricityProfilesCapability → 200
GET
/v2/electricity/state-electricity-profiles/capability/facet
Get electricity state electricity profiles capability facet
getV2ElectricityStateElectricityProfilesCapabilityFacet → 400200
GET
/v2/electricity/state-electricity-profiles/capability/data
Get electricity state electricity profiles capability data
getV2ElectricityStateElectricityProfilesCapabilityData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/capability/data
Class CapabilityDataController
postV2ElectricityStateElectricityProfilesCapabilityData body → 400200
GET
/v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel
Get electricity state electricity profiles emissions by state by fuel
getV2ElectricityStateElectricityProfilesEmissionsByStateByFuel → 200
GET
/v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/facet
Get electricity state electricity profiles emissions by state by fuel facet
getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelFacet → 400200
GET
/v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data
Get electricity state electricity profiles emissions by state by fuel data
getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data
Return sep emissions-by-state-by-fuel Data
postV2ElectricityStateElectricityProfilesEmissionsByStateByFuelData body → 400200
GET
/v2/electricity/state-electricity-profiles/energy-efficiency
Get electricity state electricity profiles energy efficiency
getV2ElectricityStateElectricityProfilesEnergyEfficiency → 200
GET
/v2/electricity/state-electricity-profiles/energy-efficiency/facet
Get electricity state electricity profiles energy efficiency facet
getV2ElectricityStateElectricityProfilesEnergyEfficiencyFacet → 400200
GET
/v2/electricity/state-electricity-profiles/energy-efficiency/data
Get electricity state electricity profiles energy efficiency data
getV2ElectricityStateElectricityProfilesEnergyEfficiencyData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/energy-efficiency/data
Return sep energy-effiency Data
postV2ElectricityStateElectricityProfilesEnergyEfficiencyData body → 400200
GET
/v2/electricity/state-electricity-profiles/meters
Get electricity state electricity profiles meters
getV2ElectricityStateElectricityProfilesMeters → 200
GET
/v2/electricity/state-electricity-profiles/meters/facet
Get electricity state electricity profiles meters facet
getV2ElectricityStateElectricityProfilesMetersFacet → 400200
GET
/v2/electricity/state-electricity-profiles/meters/data
Get electricity state electricity profiles meters data
getV2ElectricityStateElectricityProfilesMetersData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/meters/data
Return sep meters Data
postV2ElectricityStateElectricityProfilesMetersData body → 400200
GET
/v2/electricity/state-electricity-profiles/net-metering
Get electricity state electricity profiles net metering
getV2ElectricityStateElectricityProfilesNetMetering → 200
GET
/v2/electricity/state-electricity-profiles/net-metering/facet
Get electricity state electricity profiles net metering facet
getV2ElectricityStateElectricityProfilesNetMeteringFacet → 400200
GET
/v2/electricity/state-electricity-profiles/net-metering/data
Get electricity state electricity profiles net metering data
getV2ElectricityStateElectricityProfilesNetMeteringData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/net-metering/data
Return sep net-metering Data
postV2ElectricityStateElectricityProfilesNetMeteringData body → 400200
GET
/v2/electricity/sep
Class SEPController
getV2ElectricitySep → 200
GET
/v2/electricity/state-electricity-profiles/source-disposition
Get electricity state electricity profiles source disposition
getV2ElectricityStateElectricityProfilesSourceDisposition → 200
GET
/v2/electricity/state-electricity-profiles/source-disposition/facet
Get electricity state electricity profiles source disposition facet
getV2ElectricityStateElectricityProfilesSourceDispositionFacet → 400200
GET
/v2/electricity/state-electricity-profiles/source-disposition/data
Get electricity state electricity profiles source disposition data
getV2ElectricityStateElectricityProfilesSourceDispositionData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/source-disposition/data
Return sep source-disposition Data
postV2ElectricityStateElectricityProfilesSourceDispositionData body → 400200
GET
/v2/electricity/state-electricity-profiles/summary
Get electricity state electricity profiles summary
getV2ElectricityStateElectricityProfilesSummary → 200
GET
/v2/electricity/state-electricity-profiles/summary/facet
Get electricity state electricity profiles summary facet
getV2ElectricityStateElectricityProfilesSummaryFacet → 400200
GET
/v2/electricity/state-electricity-profiles/summary/data
Get electricity state electricity profiles summary data
getV2ElectricityStateElectricityProfilesSummaryData 8 params → 400200
POST
/v2/electricity/state-electricity-profiles/summary/data
Return sep summary Data
postV2ElectricityStateElectricityProfilesSummaryData body → 400200

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-sep-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 COAL API
Department of Energy CRUD_IMPORTS API
Department of Energy DBF API
Department of Energy ELEC API
Department of Energy EMISS API
Where this information came from

This is an independent, third-party profile of Department of Energy SEP 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.