The Prezio API provides data about various organizations in the electricity value chain. Finding the right organizations for a location is typically the first step in retrieving accurate electricity pricing.

​
Organization Types

DSO

Distribution System Operators manage local electricity grids connecting to homes and businesses. They operate as regulated monopolies in specific geographic areas.

TSO

Transmission System Operators manage high-voltage transmission lines across regions and national borders.

RET

Retailers sell electricity to end users through various contract types, including fixed, variable, and spot-based pricing models.

TAX

Tax Authorities collect VAT and specific electricity taxes, which vary by country and sometimes by region.

AUTH

Regulatory Authorities oversee energy markets, implement policy objectives, and may impose fees or provide subsidies.

OTHER

Other Organizations include any additional entities that may impact electricity pricing in specific markets.

​
Finding Organizations by Location

The /organizations/ endpoint identifies which organizations are applicable for a specific location. This is typically the first step before retrieving tariffs. 
GET /organizations/?country=SE&address=Storgatan 1, Stockholm
Finding applicable organizations first helps you understand the market structure for a specific location before exploring available tariffs.

​
Local Consumer Types

It is recommended to filter organizations by the consumer’s local_consumer_type to ensure that the organization is applicable for the consumer. To find out which local consumer types are available for a country, use the local-consumer-types endpoint first. You can filter organizations by consumer_type and by repeatable local_consumer_type keys/ids:
  • consumer_types: normalized categories (e.g., RESIDENTIAL, BUSINESS)
  • local_consumer_types: granular, country-specific labels with stable ids
local_consumer_types is also provided in response for your reference when building selection UIs. Example (truncated): 
{
  "id": "org_123",
  "name": "Stockholm Grid Services",
  "type": "DSO",
  "local_consumer_types": [
    {"id": "lct_6", "key": "SE_Privatpersoner", "name": "Privatpersoner", "consumer_type": "RESIDENTIAL"}
  ]
}

​
Filtering Options

Location-Based Filtering

Find organizations serving a specific location:
# Using an address
GET /organizations/?country=DK&address=Rådhuspladsen 1, Copenhagen

# Using coordinates
GET /organizations/?country=DK&latitude=55.6761&longitude=12.5683
Filter by organization type:
# Find only retailers in a location
GET /organizations/?country=NO&address=Oslo&type=RET

# Find only DSOs in a location
GET /organizations/?country=SE&address=Stockholm&type=DSO
Available types: DSO, TSO, RET, TAX, AUTH, OTHER
Find organizations valid at a specific date:
# Organizations valid on January 1, 2023
GET /organizations/?country=SE&valid_at=2023-01-01T00:00:00Z
This is useful for historical analysis or handling organizations that have merged, been acquired, or closed.
Search by organization name:
# Search for organizations with "Vattenfall" in their name
GET /organizations/?country=SE&search=Vattenfall
The search parameter checks against organization names and related identifiers.

​
Organization Response Structure

The organizations endpoint returns key information about each applicable organization: 
{
  "id": "org_123",
  "name": "Stockholm Grid Services",
  "type": "DSO",
  "website_url": "https://stockholmgrid.se",
  "logo": "https://api.prezio.eu/media/logos/stockholm_grid.png",
  "main_tariffs": [
    {
      "id": "mta_456",
      "name": "Enkel"
    },
    {
      "id": "mta_789",
      "name": "Tidsdifferentierad"
    }
  ],
  "default_main_tariff": "mta_456"
}

​
Main Tariffs Concept

What Are Main Tariffs?

Main tariffs are umbrella groupings of related tariffs from an organization. They simplify choices for end users by organizing similar tariff variations under a recognizable name.For example, a Swedish DSO might offer an “Enkel” (Simple) main tariff with multiple variations based on fuse level (16A, 20A, 25A, etc.).

Using Main Tariffs

Main tariffs help users identify which general tariff structure they have, without needing to know specific technical details.Not all tariffs are grouped under main tariffs. Some organizations provide individual tariffs without this grouping structure.
Main tariff availability varies by organization and market. The API indicates when main tariffs are available for an organization.

​
Market Models Across Europe

European electricity markets operate under different models, affecting how organizations interact and how costs flow to end users.

​
Separated Model (Common in Scandinavia)

In this model, DSOs and retailers operate as entirely separate entities:
  • Distribution (DSO): Operates as a regulated monopoly in specific geographic areas
  • Retail (RET): Multiple retailers compete freely for customers
  • Billing: End users receive separate charges from both DSO and retailer
  • Customer Choice: Users select their retailer, but cannot choose their DSO
  • Examples: Sweden, Norway, Denmark, Finland
In some markets like Sweden, users can choose between different DSO subscription types (e.g., fuse-based vs. capacity-based).
The organization endpoint will return separate DSO and retailer organizations for locations in these markets.

​
Implementation Workflow

1

Find Applicable Organizations

Use the /organizations/ endpoint with location parameters to discover which organizations serve a specific address or coordinates.
GET /organizations/?country=SE&address=Stockholm
2

Identify Main Tariffs

Review the main_tariffs field in organization responses to understand available tariff groupings.
3

Retrieve Specific Tariffs

Use the organization ID or main tariff ID to find detailed tariff information:
# Get all tariffs from an organization
GET /tariffs/?country=SE&organization=org_123

# Get all tariffs under a specific main tariff
GET /tariffs/?country=SE&main_tariff=mta_456
4

Calculate Prices

Use the tariff IDs with the /live/ or /calculate/ endpoints to get actual pricing information.
In liberalized markets, end users can choose their retailer. Compare pricing across retailers by retrieving tariffs from different RET-type organizations for the same location.

​
Special Charges and Subsidies

Regional Variations

Many countries have region-specific charges or subsidies based on:
  • Local grid infrastructure costs
  • Regional renewable energy development
  • Municipal or regional taxes
The Prezio API returns these regional variations based on the location provided in your requests.
Some markets have special fees or credits based on criteria such as:
  • Income level or social support status
  • Business type or industry classification
  • Energy usage patterns or volume
  • Geographic factors (e.g., northern regions with higher heating needs)
These eligibility-based components are included in API responses when applicable to the specified parameters.

​
In API Responses

Organization information appears in API responses to help you understand the source of each price component: 
{
  "tariff_elements": [
    {
      "element_id": "com_123",
      "element_name": "Grid Connection Fee",
      "organization_id": "org_456",
      "organization_name": "Stockholm Grid Services",
      "organization_type": "DSO"
    },
    {
      "element_id": "com_789",
      "element_name": "Energy Cost",
      "organization_id": "org_101",
      "organization_name": "Nordic Power Retail",
      "organization_type": "RET"
    }
  ]
}
In liberalized markets, end users can choose their retailer. To simulate different retailer options, use the API to retrieve tariffs filtered by different retailer organizations.
The Prezio API handles the complexity of different market models automatically. You’ll always receive accurately structured pricing data regardless of the underlying market organization.