Calculate Tariff Rate ($/kWh)

post https://api.arcadia.com/spark/tariff_rates

Calculates marginal rate ($/kWh) for a short-term time period on the electric tariff a given utility account is subscribed to. This endpoint will report appropriate costs for TOU periods (daily peak/off-peak hours, weekend schedules, seasonal changes).
This endpoint is not recommended for monthly bill reproduction. Marginal rates generally do not include monthly adjustments or charges such as tiering (costs are generally reported at the base tier), fixed charges, monthly discounts, special event days, etc.

Body Params

utility_account_id

integer

(Beta - due to limited coverage) The unique ID of the utility account that this calculation is being run against. Either a utility_account_id or main_tariff_id is required for a valid request.

main_tariff_id

string

The Genability 'masterTariffId' unique identifier for this tariff. See Genability documentation for details. Either a utility_account_id or main_tariff_id is required for a valid request.

start_time

date-time

required

ISO8601 timestamp indicating start time. Note that the timestamp will be rounded down to the start of latest time_block_resolution

end_time

date-time

ISO8601 timestamp indicating end of time period. Note that the timestamp will be rounded down to the start of latest time_block_resolution

time_block_resolution

string

Defaults to 1h

Requested time resolution

Headers

Arcadia-Version

string

required

Defaults to 2022-10-13

The Arcadia-Version for the request

Response

Response body

object

tariff

object

required

Information about a tariff.

main_tariff_id

string

required

The Genability 'masterTariffId' unique identifier for this tariff. See Genability documentation for details.

property_inputs

array of objects

Properties applied to this tariff which may affect the calculated cost of electricity.

property_inputs

object

string

required

value

required

supplier_name

string | null

The name of the retail electricity supplier or the community choice aggregator. If there is no retail electricity supplier or community choice aggregator, this field is null.

tariff_code

string

required

Abbreviation code of the tariff used for this calculation.

tariff_name

string

required

Full name of the tariff used for this calculation.

utility_name

string

required

Name of the utility associated with this tariff

rates_cost_per_kwh

object

required

Timeseries with data array of $/kWh rates

data

array of objects

required

Array of TimeSeriesItems indicating $/kWh rates for each requested time period

data*

object

timestamp

date-time

required

ISO8601 timestamp indicating time of data collection

value

number

required

Data value of resource

freq

string

required

The interval of the TimeSeriesItems in the data array

5m 10m 15m 30m 1h

Headers

object

Arcadia-Version

string

The Arcadia-Version for the response

Language

Credentials

Bearer


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://api.arcadia.com/spark/tariff_rates \
3
     --header 'Arcadia-Version: 2022-10-13' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --header 'from-readme: true' \
7
     --data '
8
{
9
  "time_block_resolution": "1h"
10
}
11
'


xxxxxxxxxx
24
 
1
{
2
  "tariff": {
3
    "main_tariff_id": "gen_mtid_3331108",
4
    "property_inputs": [
5
      {
6
        "id": "territoryId",
7
        "value": 3
8
      }
9
    ],
10
    "supplier_name": "East Bay Community Energy",
11
    "tariff_code": "EV-2A-TOU",
12
    "tariff_name": "Residential - Time of Use - Plug-In Electric Vehicle 2",
13
    "utility_name": "Pacific Gas & Electric"
14
  },
15
  "rates_cost_per_kwh": {
16
    "data": [
17
      {
18
        "timestamp": "2025-03-26T22:31:32.641Z",
19
        "value": 0
20
      }
21
    ],
22
    "freq": "5m"
23
  }
24
}

200Success