Skip to main content
GET
/
cost-of-energy
/
v1
/
tariffs
/
{tariff_id}
Get Tariff
curl --request GET \
  --url https://api.engrate.io/v1/cost-of-energy/v1/tariffs/{tariff_id} \
  --header 'Authorization: <api-key>'
{
  "available_from": "2024-01-01T00:00:00+01:00",
  "eligibility": {
    "fuse_size": {
      "unit": "A",
      "value": 20
    },
    "metering_grid_area_ids": [
      "0199c317-25ec-7c00-b1a0-a1b2c3d4e5f6",
      "0199c317-25ec-7c00-b1a0-f6e5d4c3b2a1"
    ],
    "other": [
      "fuse_based"
    ],
    "type": "system_operator"
  },
  "id": "0199c317-25ec-7cf7-94cc-32a39f068433",
  "name": "Säkringsabonnemang - 20 A",
  "summary": "Fuse-based tariff for 20A with energy tax and monthly subscription fee.",
  "tariff_components": [
    {
      "applicable_from": "2026-01-01T00:00:00+01:00",
      "cost": {
        "id": "cost",
        "resolution": "quarter_hourly",
        "unit": "SEK"
      },
      "datasets": [
        {
          "id": "quarter-hourly-energy-offtake",
          "resolution": "quarter_hourly",
          "unit": "kWh"
        }
      ],
      "functions": [
        {
          "function": "multiply",
          "left": {
            "id": "quarter-hourly-energy-offtake",
            "resolution": "quarter_hourly",
            "unit": "kWh"
          },
          "output": {
            "id": "cost",
            "resolution": "quarter_hourly",
            "unit": "SEK"
          },
          "right": {
            "unit": "SEK_per_kWh",
            "value": 0.36
          }
        }
      ],
      "name": "Energiskatt",
      "timezone": "Europe/Stockholm"
    },
    {
      "applicable_from": "2025-01-01T00:00:00+01:00",
      "cost": {
        "id": "cost",
        "resolution": "monthly",
        "unit": "SEK"
      },
      "datasets": [],
      "functions": [
        {
          "function": "constant",
          "output": {
            "id": "cost",
            "resolution": "monthly",
            "unit": "SEK"
          },
          "resolution": "monthly",
          "value": {
            "unit": "SEK",
            "value": 187.5
          }
        }
      ],
      "name": "Abonnemangsavgift",
      "timezone": "Europe/Stockholm"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
tariff_id
string<uuid>
required

Response

Successful Response

Represents a tariff - a rate plan - for a metering point, including eligibility criteria, availability period and one or more Tariff Components, which describe the cost structure and how it's changed over time.

These are long-lived, like "Fuse Tariff 20A", offered by some Party acting as a System Operator.

​
eligibility
Eligibility · object
required

Criteria the customer and metering point must meet.

Example:
{
  "fuse_size": { "unit": "A", "value": 20 },
  "metering_grid_area_ids": [
    "0199c317-25ec-7c00-b1a0-a1b2c3d4e5f6",
    "0199c317-25ec-7c00-b1a0-f6e5d4c3b2a1"
  ],
  "other": ["fuse_based"],
  "type": "system_operator"
}
​
id
string
required

Unique identifier within the Engrate systems.

Example:

"0199c317-25ec-7cf7-94cc-32a39f068433"

​
name
string
required

Tariff name as given by the system operator.

Example:

"Säkringsabonnemang - 20 A"

​
tariff_components
TariffComponent · object[]
required

Tariff components applicable for this tariff.

Example:
[
  {
    "applicable_from": "2025-01-01T00:00:00+01:00",
    "cost": {
      "id": "cost",
      "resolution": "hourly",
      "unit": "SEK"
    },
    "datasets": [
      {
        "id": "quarter-hourly-energy-offtake",
        "resolution": "quarter_hourly",
        "unit": "kWh"
      }
    ],
    "functions": [
      {
        "aggregation_function": "sum",
        "function": "aggregate",
        "input": {
          "id": "quarter-hourly-energy-offtake",
          "resolution": "quarter_hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "resolution": "hourly"
      },
      {
        "function": "multiply",
        "left": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "cost",
          "resolution": "hourly",
          "unit": "SEK"
        },
        "right": { "unit": "SEK_per_kWh", "value": 0.536 }
      }
    ],
    "name": "Energiskatt",
    "timezone": "Europe/Stockholm"
  },
  {
    "applicable_from": "2025-01-01T00:00:00+01:00",
    "cost": {
      "id": "cost",
      "resolution": "monthly",
      "unit": "SEK"
    },
    "datasets": [],
    "functions": [
      {
        "function": "constant",
        "output": {
          "id": "cost",
          "resolution": "monthly",
          "unit": "SEK"
        },
        "resolution": "monthly",
        "value": { "unit": "SEK", "value": 187.5 }
      }
    ],
    "name": "Abonnemangsavgift",
    "timezone": "Europe/Stockholm"
  }
]
​
annotations
string | null

Additional remarks, meant for human reading.

Example:

"Tariff needs to be actively requested."

​
available_from
string<date-time> | null

ISO 8601 formatted datetime from when the tariff becomes available, if any. If null, available immediately.

Example:

"2024-01-01T00:00:00+01:00"

​
available_to
string<date-time> | null

ISO 8601 formatted datetime after which the tariff ceases to be available. If null, available until further notice.

Example:

"2026-01-01T00:00:00+01:00"

​
summary
string | null

Brief human-readable summary of the tariff and its tariff components.

Example:

"Fuse-based tariff for 20A with energy tax and monthly subscription fee."