Skip to main content
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
      }
    }
  },
  "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",
      "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",
      "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,
FI,
GB,
NO,
RO,
SE
include_tariff_properties
boolean
default:false

When set to true, includes tariff properties required for the returned tariffs.

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.

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

OK

count
integer

Total number of items across all pages

Example:

12

next
string | null

URL for the next page of results, null if no next page

Example:

"https://api.prezio.com/api/tariffs/?page=2"

previous
string | null

URL for the previous page of results, null if no previous page

Example:

"https://api.prezio.com/api/tariffs/?page=1"

context
object
tariff_properties
object[]
results
object[]