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>'
{
  "component_rates": [
    {
      "component": {
        "applicable_from": "2026-01-01T00:00:00+01:00",
        "name": "Energiskatt"
      },
      "rate": {
        "dataset_id": "quarter-hourly-energy-offtake",
        "intervals": [
          {
            "end_time": "2026-01-02T00:00:00Z",
            "rate": 0.36,
            "start_time": "2026-01-01T00:00:00Z"
          }
        ],
        "unit": "SEK_per_kWh"
      }
    },
    {
      "component": {
        "applicable_from": "2026-01-01T00:00:00+01:00",
        "name": "Effektavgift"
      },
      "rate": {
        "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"
      }
    }
  ],
  "dataset_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-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"
    }
  ],
  "unprojectable_components": [
    {
      "applicable_from": "2026-01-01T00:00:00+01:00",
      "name": "Abonnemangsavgift"
    }
  ]
}

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.

​
component_rates
ComponentRate · object[]
required

Per-component rate timeseries, for components that can be projected onto a per-kWh or per-kW rate. Empty if the tariff has no projectable components.

​
dataset_rates
RateTimeseries · object[]
required

Summed rate timeseries per (dataset_id, unit) group, across all projectable components contributing to that group. Empty if the tariff has no projectable components.

​
unprojectable_components
ComponentIdentity · object[]
required

Tariff components present on the tariff that could not be projected onto a rate timeseries. Listed by name and applicability window only; see Get Tariff for full component definitions.