look up a specific utility's tariff structure from the OpenEI Utility Rate Database (URDB) using the getpage parameter and parse tiered energy/demand rate arrays

domain: openei.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain a free OpenEI/NREL-issued API key (still valid after the developer.nrel.gov to developer.nlr.gov domain migration)
  2. Identify the target rate's URDB label (rate ID) from the URDB web UI or a prior version=8 search response
  3. Call GET https://api.openei.org/utility_rates?version=8&format=json&getpage={rate_label}&api_key=... to fetch the full rate record
  4. Parse the energyratestructure and demandratestructure multidimensional arrays (period, tier, rate/adjustment)
  5. Read approval and effective-date fields (startdate, enddate) to confirm the rate is currently in effect
  6. Cache the rate label locally since getpage lookups are the stable long-term reference for a given tariff version

Known gotchas

Related routes

Query the OpenEI Utility Rate Database (URDB) API for tariff structures
openei.org · 6 steps · unrated
Look up utility electricity rate structures via the OpenEI Utility Rate Database API
openei.org · 5 steps · unrated
Query electricity generation and retail price data from the EIA API v2
api.eia.gov · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans