HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Tariff APIs

Use Tariff APIs to discover utility rate plans, inspect tariff rates, and retrieve supporting metadata for cost calculations and savings analyses.

Use Tariff APIs to discover utility rate plans, inspect tariff rates, and retrieve the supporting metadata needed for accurate cost calculations and savings analyses.

Tariff data is connected to utilities, service territories, seasonal schedules, time-of-use periods, calendars, applicability properties, and tariff revision history. Use these APIs together when you need to identify the right tariff, understand how its rates apply, or explain rate behavior to users.

How these APIs fit together

  1. Use Load Serving Entities and Territories to identify the utility and service area for a customer.
  2. Use Account Tariffs to find applicable rate plans and Account Rates to inspect rates, rate bands, and applicability properties.
  3. Use Seasons, Time of Uses, and Calendars to understand when seasonal, time-of-use, holiday, billing, or dynamic pricing rules apply.
  4. Use Properties to retrieve metadata for calculation inputs and rate applicability criteria.
  5. Use Tariff History to track tariff revisions, rider changes, and variable-rate lookup updates over time.