Skip to main content
GET
/
tariffs
/
List Tariffs
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/ \
  --header 'Authorization: <api-key>'
[
  {
    "count": 5,
    "next": "https://api.prezio.eu/api/tariffs/?country=SE&organization=org_96&page=2",
    "previous": null,
    "context": {
      "organization": {
        "id": "org_96",
        "name": "Ellevio AB",
        "type": "DSO"
      },
      "default_tariff": "tar_908",
      "main_tariffs": [
        {
          "id": "mta_30",
          "name": "Effekt"
        },
        {
          "id": "mta_31",
          "name": "Edsbyn Enkel"
        },
        {
          "id": "mta_32",
          "name": "Enkel"
        },
        {
          "id": "mta_33",
          "name": "Tid"
        }
      ],
      "location": {
        "input_address": "stockholm",
        "coordinates": {
          "latitude": 59.3251172,
          "longitude": 18.0710935,
          "confidence": 1
        }
      }
    },
    "filters": [
      {
        "filter_id": "tfi_12",
        "filter_name": "Fuse Level",
        "filter_description": "Electrical fuse amperage level",
        "filter_options": [
          {
            "option_id": "tfo_5",
            "option_name": "16A"
          },
          {
            "option_id": "tfo_6",
            "option_name": "20A"
          },
          {
            "option_id": "tfo_7",
            "option_name": "25A"
          },
          {
            "option_id": "tfo_8",
            "option_name": "35A"
          }
        ],
        "default_option": "tfo_5"
      },
      {
        "filter_id": "tfi_15",
        "filter_name": "Contract Type",
        "filter_description": "Type of electricity contract",
        "filter_options": [
          {
            "option_id": "tfo_1",
            "option_name": "Enkel"
          },
          {
            "option_id": "tfo_27",
            "option_name": "Effekt"
          },
          {
            "option_id": "tfo_13",
            "option_name": "Spot"
          }
        ],
        "default_option": "tfo_1"
      },
      {
        "filter_id": "tfi_18",
        "filter_name": "Housing Type",
        "filter_description": "Type of residential property",
        "filter_options": [
          {
            "option_id": "tfo_37",
            "option_name": "Lägenhet"
          },
          {
            "option_id": "tfo_38",
            "option_name": "Villa"
          }
        ],
        "default_option": "tfo_38"
      }
    ],
    "tariff_properties": [
      {
        "id": "pro_12",
        "key": "fuse_level",
        "name": "Fuse Level",
        "data_type": "CHOICE",
        "group_key": "connection",
        "group_name": "Connection Properties",
        "question": "What is your electrical fuse level/band?",
        "description": "The amperage rating of your electrical connection",
        "choices": [
          {
            "id": "prv_5",
            "name": "16A",
            "value": "16"
          },
          {
            "id": "prv_6",
            "name": "20A",
            "value": "20"
          },
          {
            "id": "prv_7",
            "name": "25A",
            "value": "25_a"
          },
          {
            "id": "prv_8",
            "name": "35A",
            "value": "35_a"
          }
        ]
      },
      {
        "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_1",
            "name": "Enkel",
            "value": "enkel"
          },
          {
            "id": "prv_27",
            "name": "Effekt",
            "value": "effekt"
          },
          {
            "id": "prv_13",
            "name": "Spot",
            "value": "spot"
          }
        ]
      },
      {
        "id": "pro_18",
        "key": "housing_type",
        "name": "Housing Type",
        "data_type": "CHOICE",
        "group_key": "property",
        "group_name": "Property Details",
        "question": "What type of property do you live in?",
        "description": "Type of residential building",
        "choices": [
          {
            "id": "prv_37",
            "name": "Lägenhet",
            "value": "lagenhet"
          },
          {
            "id": "prv_38",
            "name": "Villa",
            "value": "villa"
          }
        ]
      }
    ],
    "results": [
      {
        "id": "tar_908",
        "name": "Enkel 16A Lägenhet",
        "observations": "Standard apartment tariff for simple pricing",
        "main_tariff": "mta_32",
        "assigned_options": [
          "tfo_5",
          "tfo_1",
          "tfo_37"
        ],
        "tariff_properties": [
          {
            "id": "prv_5",
            "property_key": "fuse_level",
            "value": "16"
          },
          {
            "id": "prv_1",
            "property_key": "contract_type",
            "value": "enkel"
          },
          {
            "id": "prv_37",
            "property_key": "housing_type",
            "value": "lagenhet"
          }
        ],
        "has_time_of_use": false,
        "has_tiers": false,
        "component_types": [
          "KWH",
          "FIXED"
        ]
      },
      {
        "id": "tar_6965",
        "name": "Effekt 16A Villa",
        "observations": "Demand-based tariff for villa properties",
        "main_tariff": "mta_30",
        "assigned_options": [
          "tfo_5",
          "tfo_27",
          "tfo_38"
        ],
        "tariff_properties": [
          {
            "id": "prv_5",
            "property_key": "fuse_level",
            "value": "16"
          },
          {
            "id": "prv_27",
            "property_key": "contract_type",
            "value": "effekt"
          },
          {
            "id": "prv_38",
            "property_key": "housing_type",
            "value": "villa"
          }
        ],
        "has_time_of_use": false,
        "has_tiers": true,
        "component_types": [
          "KWH",
          "DEMAND",
          "FIXED"
        ]
      },
      {
        "id": "tar_45",
        "name": "Spot Time Variable Business",
        "observations": "Time-variable spot pricing for business customers",
        "main_tariff": "mta_33",
        "assigned_options": [
          "tfo_13",
          "tfo_40",
          "tfo_41"
        ],
        "tariff_properties": [
          {
            "id": "prv_13",
            "property_key": "contract_type",
            "value": "spot"
          },
          {
            "id": "prv_40",
            "property_key": "consumption_level",
            "value": "lagre_arsforbrukning"
          },
          {
            "id": "prv_41",
            "property_key": "price_duration",
            "value": "1h"
          }
        ],
        "has_time_of_use": true,
        "has_tiers": true,
        "component_types": [
          "KWH",
          "DEMAND",
          "FIXED",
          "TAX",
          "CAPACITY"
        ]
      }
    ]
  }
]

Authorizations

Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

address
string

Consumer address, used for location-based filtering (required unless latitude/longitude are provided). Cannot be used together with latitude/longitude.

consumer_type
enum<string>

Filter by consumer type (RESIDENTIAL or BUSINESS). If empty, returns all consumer types.

Available options:
BUSINESS,
RESIDENTIAL
country
enum<string>
required

ISO-3166 alpha-2 country code of the requested location. Used to ensure geographic correctness.

Available options:
AT,
DK,
FR,
NO,
SE
filter_options
string

[being deprecated] Filter tariffs by specific options. Accepts comma-separated list of option IDs with tfo_ prefix.

include_filters
boolean
default:true

[being deprecated] When set to true, includes available filter options in the response for UI filtering. Will be replaced by include_tariff_properties in the future.

include_tariff_properties
boolean
default:false

[beta] When set to true, includes tariff properties required for the returned tariffs. Is expected to replace include_filters in the future.

latitude
number

Latitude coordinate (required with longitude unless address is provided). Cannot be used together with address.

local_consumer_type
string[]

Repeatable. Filter by local consumer type using key or lct_ ID. Example: ?local_consumer_type=b_lav&local_consumer_type=lct_12

longitude
number

Longitude coordinate (required with latitude unless address is provided). Cannot be used with address.

main_tariff
string

Main Tariff ID with mta_ prefix. Required if organization is not provided.

organization
string

Organization ID with org_ prefix. Required if main_tariff is not provided.

A search term.

valid_at
string

Filters for tariffs valid at a specific datetime (ISO 8601 UTC-only format accepting date YYYY-MM-DD). If empty, uses current time

Response

Success - Returns list of tariffs

context
object
required
filters
object[]
required
tariff_properties
object[]
required
results
object[]
required