EIA

EIA SEP API

Access to State Electricity Profiles

GitHub OpenAPI

Operations 36

GET /v2/electricity/state-electricity-profiles/capability/facet/{facet_id} Get electricity state electricity profiles capability facet by facet id #
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… #
GET /v2/electricity/state-electricity-profiles/energy-efficiency/facet/{facet_id} Get electricity state electricity profiles energy efficiency facet by facet id #
GET /v2/electricity/state-electricity-profiles/meters/facet/{facet_id} Get electricity state electricity profiles meters facet by facet id #
GET /v2/electricity/state-electricity-profiles/net-metering/facet/{facet_id} Get electricity state electricity profiles net metering facet by facet id #
GET /v2/electricity/state-electricity-profiles/source-disposition/facet/{facet_id} Get electricity state electricity profiles source disposition facet by facet id #
GET /v2/electricity/state-electricity-profiles/summary/facet/{facet_id} Get electricity state electricity profiles summary facet by facet id #
GET /v2/electricity/state-electricity-profiles/capability Get electricity state electricity profiles capability #
GET /v2/electricity/state-electricity-profiles/capability/facet Get electricity state electricity profiles capability facet #
GET /v2/electricity/state-electricity-profiles/capability/data Get electricity state electricity profiles capability data #
POST /v2/electricity/state-electricity-profiles/capability/data Class CapabilityDataController #
GET /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel Get electricity state electricity profiles emissions by state by fuel #
GET /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/facet Get electricity state electricity profiles emissions by state by fuel facet #
GET /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data Get electricity state electricity profiles emissions by state by fuel data #
POST /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data Return sep emissions-by-state-by-fuel Data #
GET /v2/electricity/state-electricity-profiles/energy-efficiency Get electricity state electricity profiles energy efficiency #
GET /v2/electricity/state-electricity-profiles/energy-efficiency/facet Get electricity state electricity profiles energy efficiency facet #
GET /v2/electricity/state-electricity-profiles/energy-efficiency/data Get electricity state electricity profiles energy efficiency data #
POST /v2/electricity/state-electricity-profiles/energy-efficiency/data Return sep energy-effiency Data #
GET /v2/electricity/state-electricity-profiles/meters Get electricity state electricity profiles meters #
GET /v2/electricity/state-electricity-profiles/meters/facet Get electricity state electricity profiles meters facet #
GET /v2/electricity/state-electricity-profiles/meters/data Get electricity state electricity profiles meters data #
POST /v2/electricity/state-electricity-profiles/meters/data Return sep meters Data #
GET /v2/electricity/state-electricity-profiles/net-metering Get electricity state electricity profiles net metering #
GET /v2/electricity/state-electricity-profiles/net-metering/facet Get electricity state electricity profiles net metering facet #
GET /v2/electricity/state-electricity-profiles/net-metering/data Get electricity state electricity profiles net metering data #
POST /v2/electricity/state-electricity-profiles/net-metering/data Return sep net-metering Data #
GET /v2/electricity/sep Class SEPController #
GET /v2/electricity/state-electricity-profiles/source-disposition Get electricity state electricity profiles source disposition #
GET /v2/electricity/state-electricity-profiles/source-disposition/facet Get electricity state electricity profiles source disposition facet #
GET /v2/electricity/state-electricity-profiles/source-disposition/data Get electricity state electricity profiles source disposition data #
POST /v2/electricity/state-electricity-profiles/source-disposition/data Return sep source-disposition Data #
GET /v2/electricity/state-electricity-profiles/summary Get electricity state electricity profiles summary #
GET /v2/electricity/state-electricity-profiles/summary/facet Get electricity state electricity profiles summary facet #
GET /v2/electricity/state-electricity-profiles/summary/data Get electricity state electricity profiles summary data #
POST /v2/electricity/state-electricity-profiles/summary/data Return sep summary Data #

Documentation

📖
Documentation
https://www.eia.gov/opendata/documentation.php
📖
APIReference
https://www.eia.gov/opendata/browser/
📖
Authentication
https://www.eia.gov/opendata/register.php
📖
Documentation
https://www.eia.gov/opendata/qb.php
📖
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

Specifications

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

Other Resources

🔗
Portal
https://www.eia.gov/opendata/
🔗
SignUp
https://www.eia.gov/opendata/register.php
🔗
TermsOfService
https://www.eia.gov/opendata/register.php
🔗
Console
https://www.eia.gov/opendata/browser/
🔗
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

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/eia-sep-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

eia-sep-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: EIA APIv2 SEP 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:
- name: SEP
  description: Access to State Electricity Profiles
paths:
  /v2/electricity/state-electricity-profiles/capability/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles capability facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesCapabilityFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles emissions by state by fuel facet by…
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/energy-efficiency/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles energy efficiency facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEnergyEfficiencyFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/meters/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles meters facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesMetersFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/net-metering/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles net metering facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesNetMeteringFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/source-disposition/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles source disposition facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSourceDispositionFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/summary/facet/{facet_id}:
    parameters:
    - $ref: '#/components/parameters/facetId'
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facet'
      summary: Get electricity state electricity profiles summary facet by facet id
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSummaryFacetByFacetId
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/capability:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles capability
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesCapability
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/capability/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles capability facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesCapabilityFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/capability/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles capability data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesCapabilityData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Class CapabilityDataController
      description: Electricity capability dataset controller.
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesCapabilityData
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles emissions by state by fuel
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEmissionsByStateByFuel
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles emissions by state by fuel facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles emissions by state by fuel data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEmissionsByStateByFuelData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep emissions-by-state-by-fuel Data
      description: 'Class EmissionsByStateByFuelController


        Electricity emissions EmissionsByStateByFuelController dataset controller.'
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesEmissionsByStateByFuelData
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/energy-efficiency:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles energy efficiency
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEnergyEfficiency
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/energy-efficiency/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles energy efficiency facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEnergyEfficiencyFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/energy-efficiency/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles energy efficiency data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesEnergyEfficiencyData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep energy-effiency Data
      description: 'Class EnergyEfficiencyController


        Electricity EnergyEfficiencyController dataset controller.'
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesEnergyEfficiencyData
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/meters:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles meters
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesMeters
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/meters/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles meters facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesMetersFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/meters/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles meters data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesMetersData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep meters Data
      description: Class MetersController
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesMetersData
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/net-metering:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles net metering
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesNetMetering
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/net-metering/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles net metering facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesNetMeteringFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/net-metering/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles net metering data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesNetMeteringData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep net-metering Data
      description: 'Class NetMeteringController


        Nuclear Outages 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'
      operationId: postV2ElectricityStateElectricityProfilesNetMeteringData
      x-operation-id-source: derived
  /v2/electricity/sep:
    get:
      tags:
      - SEP
      summary: Class SEPController
      description: Nuclear Outages data set top-level controller.
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/route'
      operationId: getV2ElectricitySep
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/source-disposition:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles source disposition
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSourceDisposition
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/source-disposition/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles source disposition facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSourceDispositionFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/source-disposition/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles source disposition data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSourceDispositionData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep source-disposition Data
      description: 'Class SourceDispositionDataController


        Electricity SourceDisposition dataset controller.'
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesSourceDispositionData
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/summary:
    get:
      tags:
      - SEP
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/final-route'
      summary: Get electricity state electricity profiles summary
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSummary
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/summary/facet:
    get:
      tags:
      - SEP
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/facets'
      summary: Get electricity state electricity profiles summary facet
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSummaryFacet
      x-operation-id-source: derived
  /v2/electricity/state-electricity-profiles/summary/data:
    get:
      tags:
      - SEP
      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
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      summary: Get electricity state electricity profiles summary data
      x-summary-source: derived
      operationId: getV2ElectricityStateElectricityProfilesSummaryData
      x-operation-id-source: derived
    post:
      tags:
      - SEP
      summary: Return sep summary Data
      description: 'Class SourceSummaryDataController


        Electricity SourceSummary dataset controller.'
      requestBody:
        $ref: '#/components/requestBodies/dataParams'
      responses:
        '400':
          description: Invalid input
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/responses/data'
      operationId: postV2ElectricityStateElectricityProfilesSummaryData
      x-operation-id-source: derived
components:
  schemas:
    FacetDetails:
      properties:
        totalFacets:
          type: integer
        facets:
          type: array
          items:
            $ref: '#/components/schemas/Facet'
      type: object
    FacetOptionList:
      properties:
        totalFacetOptions:
          type: integer
        facetOptions:
          type: array
          items:
            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
    FacetMetaData:
      properties:
        id:
          type: string
        description:
          type: string
      type: object
    RouteResponse:
      properties:
        response:
          $ref: '#/components/schemas/Routes'
        request:
          $ref: '#/components/schemas/RouteRequest'
      type: object
    FacetDetailsContainer:
      properties:
        apiVersion:
          type: string
        request:
          $ref: '#/components/schemas/RouteRequest'
        response:
          $ref: '#/components/schemas/FacetDetails'
      type: object
    RouteRequest:
      properties:
        command:
          type: array
          items:
            type: string
        params: {}
      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
    Frequency:
      properties:
        id:
          type: string
        description:
          type: string
        format:
          type: string
        query:
          type: string
      type: object
    RouteResponseContainer:
      properties:
        apiVersion:
          type: string
        request:
          $ref: '#/components/schemas/RouteRequest'
        response:
          $ref: '#/components/schemas/RouteResponse'
      type: object
    DataResponseContainer:
      properties:
        apiVersion:
          type: string
        request:
          $ref: '#/components/schemas/RouteRequest'
        response:
          $ref: '#/components/schemas/DataResponse'
      type: object
    FinalRouteResponseContainer:
      properties:
        apiVersion:
          type: string
        request:
          $ref: '#/components/schemas/RouteRequest'
        response:
          $ref: '#/components/schemas/FinalRouteResponse'
      type: object
    FacetOptionListContainer:
      properties:
        apiVersion:
          type: string
        request:
          $ref: '#/components/schemas/RouteRequest'
        response:
          $ref: '#/components/schemas/FacetOptionList'
      type: object
    Facet:
      properties:
        id:
          type: string
        name:
          type: string
        alias:
          type: string
      type: object
    Sort:
      properties:
        column:
          type: string
        direction:
          type: string
      type: object
    Routes:
      properties:
        routes:
          type: array
          items:
            type: string
        id:
          type: string
        name:
          type: string
        description:
          type: string
      type: object
    FinalRouteResponse:
      properties:
        response:
          $ref: '#/components/schemas/FinalRoute'
        request:
          $ref: '#/components/schemas/RouteRequest'
      type: object
    DataResponse:
      properties:
        data: {}
        dateFormat:
          type: string
        description:
          type: string
        frequency:
          type: string
        total:
          type: integer
      type: object
  responses:
    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'
    facets:
      description: List of facet options
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/FacetOptionListContainer'
    route:
      description: List of API data sets
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RouteResponseContainer'
  parameters:
    length:
      name: length
      in: query
      description: Max length of returned data
      required: false
      schema:
        type: integer
    offset:
      name: offset
      in: query
      description: Offset of returned data
      required: false
      schema:
        type: integer
    sort:
      name: sort
      in: query
      description: How to sort returned data
      required: false
      schema:
        $ref: '#/components/schemas/Sort'
    facetId:
      name: facet_id
      in: path
      description: Facet ID
      required: true
      schema:
        type: string
    facets:
      name: facets
      in: query
      description: Facets to filter by
      required: false
      schema:
        type: object
    end:
      name: end
      in: query
      description: End date to filter by
      required: false
      schema:
        type: string
    frequency:
      name: frequency
      in: query
      description: Frequency to filter by
      required: false
      schema:
        type: string
    start:
      name: start
      in: query
      description: Start date to filter by
      required: false
      schema:
        type: string
    data:
      name: data
      in: query
      description: Data columns to filter by
      required: false
      schema:
        type: array
        items:
          type: string
  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