GET
/
tariffs
/
List Tariffs
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/ \
  --header 'Authorization: <api-key>'
{
  "count": 12,
  "next": "https://api.prezio.eu/api/tariffs/?country=SE&organization=org_12&page=2",
  "previous": null,
  "context": {
    "organization": {
      "id": "org_123",
      "name": "Ellevio AB",
      "type": "DSO"
    },
    "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"
        }
      ],
      "default_option": "tfo_5"
    },
    {
      "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": "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": "apartment"
        },
        {
          "id": "prv_38",
          "name": "Villa",
          "value": "house"
        }
      ]
    }
  ],
  "results": [
    {
      "id": "tar_908",
      "name": "Tariff 16A Lägenhet",
      "observations": "Standard apartment tariff for simple pricing",
      "main_tariff": "mta_32",
      "assigned_options": [
        "tfo_5",
        "tfo_37"
      ],
      "tariff_properties": [
        {
          "id": "prv_5",
          "property_key": "fuse_level",
          "value": "16"
        },
        {
          "id": "prv_37",
          "property_key": "housing_type",
          "value": "apartment"
        }
      ],
      "has_time_of_use": false,
      "has_tiers": false,
      "component_types": [
        "KWH",
        "FIXED"
      ]
    },
    {
      "id": "tar_6965",
      "name": "Tariff 20A Villa",
      "observations": "Demand-based tariff for villa properties",
      "main_tariff": "mta_30",
      "assigned_options": [
        "tfo_5",
        "tfo_38"
      ],
      "tariff_properties": [
        {
          "id": "prv_5",
          "property_key": "fuse_level",
          "value": "16"
        },
        {
          "id": "prv_38",
          "property_key": "housing_type",
          "value": "house"
        }
      ],
      "has_time_of_use": false,
      "has_tiers": true,
      "component_types": [
        "KWH",
        "DEMAND",
        "FIXED"
      ]
    }
  ]
}

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,
DE,
DK,
ES,
GB,
NO,
SE
​
filter_options
string

Deprecated. Will be replaced by include_tariff_properties

​
include_filters
boolean
default:true

Deprecated. Will be replaced by include_tariff_properties

​
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.

​
page
integer

A page number within the paginated result set.

​
page_size
integer

Number of results to return per page.

​
search
string

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

200
application/json

OK

The response is of type object.