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.

Filtering Options

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

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.