---
title: "Calculate Tariff Rate ($/kWh)"
method: POST
path: "/spark/tariff_rates"
tags: ["Spark"]
---

# Calculate Tariff Rate ($/kWh)

`POST /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.

## Headers

- `Arcadia-Version` string, required

## Request body

- TariffRatesRequestBodyParams
  - `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](https://developer.genability.com/api-reference/tariff-api/tariff/) for details. Either a `utility_account_id` or `main_tariff_id` is required for a valid request.
  - `start_time` string, 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` string, 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` '5m' | '10m' | '15m' | '30m' | '1h' — Requested time resolution

## Response `200`

Success

- TariffRatesResponse
  - `tariff` Tariff, required — Information about a tariff.
    - `main_tariff_id` string, required — The Genability 'masterTariffId' unique identifier for this tariff. See [Genability documentation](https://developer.genability.com/api-reference/tariff-api/tariff/) for details.
    - `property_inputs` object[] — Properties applied to this tariff which may affect the calculated cost of electricity.
      - `id` string, required
      - `value` union, required
        - boolean
        - number
        - string
    - `supplier_name` string, nullable — 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` TimeSeriesItem[], required — Array of TimeSeriesItems indicating $/kWh rates for each requested time period
      - `timestamp` string, date-time, required — ISO8601 timestamp indicating time of data collection
      - `value` number, required — Data value of resource
    - `freq` '5m' | '10m' | '15m' | '30m' | '1h', required — The interval of the TimeSeriesItems in the data array

---

[API](https://skmtc.dev/arcadia/apis/arcadia-api-reference.md) · [All operations](https://skmtc.dev/arcadia/apis/arcadia-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcadia/arcadia-api-reference/revisions/468f1c903722/schema)