{"contractVersion":"parcelops.connector.v1","name":"eia","displayName":"EIA","description":"U.S. electricity generation, plant output, fuel mix, operating generators, and retirement schedules for infrastructure and site analysis.","tags":["electricity","generators","plants","infrastructure","siting"],"authentication":{"type":"api_key","required":true},"provenance":{"sourceName":"U.S. Energy Information Administration API v2","sourceUrl":"https://api.eia.gov/","apiBaseUrl":"https://api.eia.gov/","documentationUrl":"https://www.eia.gov/opendata/documentation.php"},"freshness":{"status":"not_declared"},"coverage":{"geographic":{"status":"not_declared"},"temporal":{"status":"not_declared"}},"methods":{"total":5,"items":[{"name":"getElectricityData","description":"Get Electricity Data","requiredParams":["dataset"],"inputSchema":{"type":"object","properties":{"dataset":{"type":"string","maxLength":160},"data":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":120}},"facets":{"type":"object","maxProperties":20,"additionalProperties":true},"frequency":{"type":"string","enum":["monthly","quarterly","annual"]},"start":{"type":"string","maxLength":20},"end":{"type":"string","maxLength":20},"length":{"type":"integer","minimum":1,"maximum":5000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["dataset"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["energy-series"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"length"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]},{"name":"searchGenerators","description":"Search Generators","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"fuelType":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"primeMover":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"balancingAuthority":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"status":{"type":"string","maxLength":80},"sector":{"type":"string","maxLength":80},"minCapacityMw":{"type":"number","minimum":0},"start":{"type":"string","maxLength":20},"end":{"type":"string","maxLength":20},"length":{"type":"integer","minimum":1,"maximum":5000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["electric-generator"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"length"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]},{"name":"getPlantGeneration","description":"Get Plant Generation","requiredParams":["plantId","start","end"],"inputSchema":{"type":"object","properties":{"plantId":{"oneOf":[{"type":"string","maxLength":30},{"type":"integer","minimum":0}]},"start":{"type":"string","maxLength":20},"end":{"type":"string","maxLength":20},"fuelType":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"primeMover":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"frequency":{"type":"string","enum":["monthly","quarterly","annual"]},"length":{"type":"integer","minimum":1,"maximum":5000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["plantId","start","end"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["plant-generation"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"length"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]},{"name":"getRetirementSchedule","description":"Get Retirement Schedule","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"fuelType":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"year":{"type":"integer","minimum":1990,"maximum":2200},"start":{"type":"string","maxLength":20},"end":{"type":"string","maxLength":20},"length":{"type":"integer","minimum":1,"maximum":5000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["generator-retirement"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"length"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]},{"name":"getFuelMix","description":"Get EIA electricity generation by fuel for one state or balancing authority and time period.","requiredParams":["time"],"inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"balancingAuthority":{"oneOf":[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"type":"string","maxLength":20}}]},"time":{"type":"string","maxLength":20},"frequency":{"type":"string","enum":["monthly","quarterly","annual"]},"length":{"type":"integer","minimum":1,"maximum":5000}},"required":["time"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["fuel-mix"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]}]},"caveats":["Coverage and frequency depend on the selected dataset.","JSON responses are capped at 5,000 rows; use offset and length for paging."]}