GET
/
tariffs
/
{id}
/
Get detailed tariff information
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/{id}/ \
  --header 'Authorization: <api-key>'
{
  "id": "tar_45",
  "name": "Advanced Business Tariff",
  "has_time_of_use": true,
  "has_tiers": true,
  "has_calculation_input": true,
  "has_properties": true,
  "local_consumer_types": [
    {
      "id": "lct_123",
      "key": "b_low",
      "name": "Business Low Voltage",
      "consumer_type": "BUSINESS"
    }
  ],
  "context": {
    "organization": {
      "id": "org_285",
      "name": "Copenhagen DSO",
      "type": "DSO"
    },
    "main_tariff": {
      "id": "mta_33",
      "name": "Advanced Pricing",
      "description": "Time-variable pricing with demand components"
    }
  },
  "tariff_properties": [
    {
      "id": "pro_15",
      "key": "contract_type",
      "name": "Contract Type",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "What type of electricity contract do you prefer?",
      "description": "Different pricing structures available",
      "choices": [
        {
          "id": "prv_13",
          "name": "Spot",
          "value": "spot"
        }
      ]
    },
    {
      "id": "pro_16",
      "key": "price_duration",
      "name": "Price Variability Duration",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "How often do you want price updates?",
      "description": "Frequency of price changes",
      "choices": [
        {
          "id": "prv_41",
          "name": "Hourly",
          "value": "1h"
        }
      ]
    }
  ],
  "tou_levels": [
    {
      "id": "tou_146",
      "name": "Peak",
      "type": "ON_PEAK",
      "periods": [
        {
          "from_time": "17:00",
          "to_time": "20:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 17:00-20:59"
        }
      ]
    },
    {
      "id": "tou_162",
      "name": "Partial peak",
      "type": "PARTIAL_PEAK",
      "periods": [
        {
          "from_time": "05:00",
          "to_time": "16:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 05:00-16:59"
        },
        {
          "from_time": "21:00",
          "to_time": "23:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 21:00-23:59"
        }
      ]
    },
    {
      "id": "tou_145",
      "name": "Off-peak",
      "type": "OFF_PEAK",
      "periods": [
        {
          "from_time": "00:00",
          "to_time": "04:59",
          "from_day": 1,
          "to_day": 0,
          "summary": "Mon-Sun: 00:00-04:59"
        }
      ]
    }
  ],
  "components": [
    {
      "id": "com_1889",
      "name": "TOU Demand",
      "key": "tou_demand",
      "description": "Time-of-use demand charge",
      "type": "DEMAND",
      "unit": "kw_per_month",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": "2025-12-31T23:59:59+01:00",
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "peak_demand",
          "name": "Peak Demand",
          "input_unit": "KW",
          "input_period": "MONTH",
          "choices": [
            {
              "key": "peak_demand_single",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15555",
      "name": "Energy Consumption (kWh)",
      "key": "kwh",
      "description": "Variable energy consumption charge",
      "type": "KWH",
      "unit": "kwh",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "consumption",
          "name": "Energy Consumption (kWh)",
          "input_unit": "KWH",
          "input_period": null,
          "choices": [
            {
              "key": "consumption_profile",
              "type": "TIME_SERIES"
            },
            {
              "key": "consumption_total",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15552",
      "name": "Capacity Fuses",
      "key": "capacity_fuses",
      "description": "Fixed charge based on fuse level",
      "type": "FIXED",
      "unit": "per_month",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "PRICE_PROPERTY",
          "key": "fuse_level",
          "name": "Fuse Level",
          "data_type": "CHOICE",
          "choices": [
            "16",
            "20",
            "25"
          ]
        }
      ]
    },
    {
      "id": "com_15551",
      "name": "Energy Tax",
      "key": "energy_tax",
      "description": "Government energy tax",
      "type": "TAX",
      "unit": "percent",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-07-01T00:00:00+02:00",
      "to": null
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

​
id
string
required

Tariff ID with "tar_" prefix or raw integer (e.g., "tar_789", "789")

Query Parameters

​
include_tariff_properties
boolean

Include tariff_properties (similar to the data from the list endpoint) section in response (default: false)

​
include_tou_details
boolean

Include detailed information about tou_levels including periods (default: false)

​
valid_at
string

Filter components to show only those with active prices at the specified datetime. Also determines the validity range shown in component 'from' and 'to' fields, and affects the calculation of tariff-level flags. Format: 'YYYY-MM-DDTHH:MM:SS' (ISO 8601). If not provided, uses current time.

Response

OK

​
id
integer
required
​
name
string
required
Maximum length: 255
​
has_time_of_use
boolean
required

Flag indicating if the tariff has time-of-use pricing

Example:

true

​
has_tiers
boolean
required

Flag indicating if the tariff has tiered pricing

Example:

false

​
has_calculation_input
boolean
required

Flag indicating if the tariff has some calculation inputs (used for advanced calculations)

Example:

true

​
has_properties
boolean
required

Flag indicating if the tariff has price-level properties (used for advanced calculations)

Example:

true

​
local_consumer_types
object[]
required
​
tariff_properties
object[]
required
​
tou_levels
object[]
required