GET
/
tariffs
/
List Tariffs
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/ \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "count": 3,
      "next": "https://api.prezio.eu/api/tariffs/?country=DK&organization=org_123&page=2",
      "previous": null,
      "context": {
        "organization": {
          "id": "org_123",
          "name": "Radius Elnet",
          "type": "DSO",
          "website_url": "https://radiuselnet.dk"
        },
        "default_tariff": "tar_789",
        "main_tariffs": [
          {
            "id": "mta_456",
            "name": "C Tariff"
          }
        ],
        "location": {
          "input_address": "Copenhagen, Denmark",
          "coordinates": {
            "latitude": 55.6867,
            "longitude": 12.5701,
            "confidence": 9
          }
        }
      },
      "filters": [
        {
          "filter_id": "tfi_12",
          "filter_name": "Customer Type",
          "filter_description": "Type of customer",
          "filter_options": [
            {
              "option_id": "tfo_5",
              "option_name": "Residential"
            },
            {
              "option_id": "tfo_6",
              "option_name": "Business"
            }
          ],
          "default_option": "tfo_5"
        }
      ],
      "results": [
        {
          "id": "tar_789",
          "name": "C Customer Tariff",
          "observations": "Standard residential tariff",
          "main_tariff": "mta_456",
          "assigned_options": [
            "tfo_5"
          ],
          "consumer_types": [
            "RESIDENTIAL"
          ],
          "has_time_of_use": true,
          "has_tiers": false,
          "has_eligibilities": false,
          "component_types": [
            "KWH",
            "FIXED"
          ]
        },
        {
          "id": "tar_790",
          "name": "C Business Tariff",
          "observations": "Standard business tariff",
          "main_tariff": "mta_456",
          "assigned_options": [
            "tfo_6"
          ],
          "consumer_types": [
            "BUSINESS"
          ],
          "has_time_of_use": true,
          "has_tiers": true,
          "has_eligibilities": true,
          "component_types": [
            "KWH",
            "DEMAND",
            "FIXED"
          ]
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
address
string

Full address 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)

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

Country code of the requested location. Used to ensure geographic correctness.

  • DK: Denmark
  • SE: Sweden
  • NO: Norway
Available options:
DK,
NO,
SE
​
filter_options
string

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

​
include_filters
boolean
default:true

When set to true, includes available filter options in the response for UI filtering.

​
latitude
number

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

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

​
search
string

A search term.

​
valid_at
string

Filter for tariffs valid at specified date (format: YYYY-MM-DD). If omitted, uses current date.

Response

200
application/json

Successfully retrieved tariffs

The response is of type object.