Model utility tariffs with the Arcadia tariff API

Verified steps

1. Obtain API credentials from Arcadia (docs.arcadia.com) and review the versioned API reference; the current stable version is accessible under the v2022-12-21 path — check docs.arcadia.com for the latest supported version.
2. Query the Load Serving Entities endpoint to retrieve the LSE ID for the target utility, filtering by state or zip code; the LSE ID is required for all subsequent tariff lookups.
3. Fetch available tariffs for the LSE using GET /tariffs?lseId={id}&customerClass={residential|commercial|industrial}&effectiveOn={date}; each tariff object includes its tariff ID, name, customer class, and effective date range.
4. Retrieve the full tariff structure via GET /tariffs/{tariffId} to obtain rate bands, time-of-use schedules (referencing TimeOfUse objects), tier breakpoints, demand charge definitions, and associated Calendar objects for holiday/critical-peak schedules.
5. Use the Tariff Calculate endpoint (POST /calculate or the equivalent in current docs) to submit an interval load profile and receive a computed bill breakdown by charge component without implementing your own tariff engine.
6. Subscribe to tariff change webhooks or poll the Tariff History endpoint periodically to detect rate updates; Arcadia tracks changes across 25,000+ North American tariffs.