v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Energy

Utility tariff schedules (NREL / OpenEI URDB)

Electricity utility tariff schedules from the NREL / OpenEI U.S. Utility Rate Database (URDB): energy and demand rate structures with their time-of-use period schedules, and fixed and minimum charges, by utility. Select a utility from the periodically ingested URDB snapshot by EIA utility id (eiaid) or by a case-insensitive name substring (utility - an ambiguous substring returns the candidate utilities to choose from); or pass lat and lon (with an optional radius in miles, default 5, max 200) for a location lookup served live from OpenEI. Filter by sector (residential, commercial, industrial, lighting). Community- and utility-submitted schedules, provided as-is under CC BY 4.0; verify against the utility tariff sheet before billing use.

get/api/v2/energy/tariffs

Query parameters

eiaidinteger nullable

EIA utility id to load from the URDB snapshot.

Example:18449

EIA utility id to load from the URDB snapshot.

utilitystring nullable

Case-insensitive utility-name substring (URDB snapshot).

Example:Talquin

Case-insensitive utility-name substring (URDB snapshot).

latnumber nullable

Latitude for a geo lookup (pair with lon).

Example:37.77

Latitude for a geo lookup (pair with lon).

lonnumber nullable

Longitude for a geo lookup (pair with lat).

Example:-122.42

Longitude for a geo lookup (pair with lat).

radiusnumber

Geo search radius in miles (geo lookup only).

sector'residential' | 'commercial' | 'industrial' | 'lighting' | 'all'

residential | commercial | industrial | lighting | all.

approvedboolean

Restrict to NREL-approved schedules (catalog is approved-only; geo passes it through).

limitinteger

Maximum tariffs (or candidate utilities) returned.

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "eiaid": 18449,
      "utility": "Talquin",
      "lat": 37.77,
      "lon": -122.42,
      "radius": 5,
      "sector": "all",
      "approved": true,
      "limit": 50
    },
    "mode": "catalog",
    "snapshot_date": "2026-07-16",
    "utility": {
      "eiaid": 18449,
      "name": "Talquin Electric Coop, Inc"
    },
    "matches": [
      {
        "eiaid": 18449,
        "name": "Talquin Electric Coop, Inc"
      }
    ],
    "tariffs": [
      {
        "label": "539f6f4bec4f024411ec95dd",
        "name": "Residential Service",
        "utility": "Talquin Electric Coop, Inc",
        "eiaid": 18449,
        "sector": "Residential",
        "uri": "https://openei.org/apps/USURDB/rate/view/539f6f4bec4f024411ec95dd",
        "start_date": "2024-01-01",
        "fixed_charge": {
          "amount": 15,
          "unit": "$/month"
        },
        "min_charge": {
          "amount": 15,
          "unit": "$/month"
        },
        "energy": {
          "tiers_by_period": [
            [
              {
                "rate": 0.11,
                "adj": 0.01,
                "effective_rate": 0.12,
                "max": 500,
                "unit": "kWh"
              }
            ]
          ]
        },
        "demand": {
          "tiers_by_period": [
            [
              {
                "rate": 0.11,
                "adj": 0.01,
                "effective_rate": 0.12,
                "max": 500,
                "unit": "kWh"
              }
            ]
          ],
          "unit": "kW",
          "flat_tiers_by_period": [
            [
              {
                "rate": 0.11,
                "adj": 0.01,
                "effective_rate": 0.12,
                "max": 500,
                "unit": "kWh"
              }
            ]
          ]
        }
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "eia/rto",
          "source_name": "EIA",
          "licence": "public-domain",
          "citation": "U.S. Energy Information Administration, Hourly Electric Grid Monitor (Form EIA-930)",
          "disclaimer": "Operational electric-grid data; preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    },
    "disclaimer": "Utility tariff schedules are as-is; verify against the utility tariff sheet."
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}