Skip to main content
GET
/
cost-of-energy
/
v1
/
tariffs
/
{tariff_id}
/
simplified
Get Simplified Tariff
curl --request GET \
  --url https://api.engrate.io/cost-of-energy/v1/tariffs/{tariff_id}/simplified \
  --header 'Authorization: <api-key>'
{
  "rates": [
    {
      "dataset_id": "quarter-hourly-energy-offtake",
      "intervals": [
        {
          "end_time": "2026-01-02T00:00:00Z",
          "rate": 0.56,
          "start_time": "2026-01-01T00:00:00Z"
        }
      ],
      "unit": "SEK_per_kWh"
    },
    {
      "dataset_id": "quarter-hourly-energy-injection",
      "intervals": [
        {
          "end_time": "2026-01-02T00:00:00Z",
          "rate": 0.06,
          "start_time": "2026-01-01T00:00:00Z"
        }
      ],
      "unit": "SEK_per_kWh"
    },
    {
      "dataset_id": "quarter-hourly-energy-offtake",
      "intervals": [
        {
          "end_time": "2026-01-01T06:00:00Z",
          "rate": 0,
          "start_time": "2026-01-01T00:00:00Z"
        },
        {
          "end_time": "2026-01-01T22:00:00Z",
          "rate": 50,
          "start_time": "2026-01-01T06:00:00Z"
        },
        {
          "end_time": "2026-01-02T00:00:00Z",
          "rate": 0,
          "start_time": "2026-01-01T22:00:00Z"
        }
      ],
      "unit": "SEK_per_kW"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.engrate.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Path Parameters

tariff_id
string<uuid>
required

Query Parameters

start_time
string<date-time>
required

ISO 8601 timezone-aware datetime at which the range begins (inclusive).

end_time
string<date-time>
required

ISO 8601 timezone-aware datetime at which the range ends (exclusive). Must be strictly greater than start_time.

Response

Successful Response

Indicative, simplified view of a Tariff's rates over a time range.

rates
RateTimeseries · object[]
required

One rate timeseries per (dataset_id, unit) group with at least one contributing component. Empty if the tariff has no components that fit a per-kWh or per-kW rate.