Tariffs are the pricing structures that determine how electricity is billed. After identifying relevant organizations for a location, you’ll use the tariffs endpoint to find specific applicable pricing schemes.

​
Tariff Selection Workflow

1

Find Organizations

Use the /organizations/ endpoint to identify which organizations serve a specific location.

2

Select Organization

End users typically need to select which retailer they use (in liberalized markets where choice exists).

3

Get Applicable Tariffs

Use the /tariffs/ endpoint with organization ID to find available tariffs.

4

Apply Filters

Use filters to narrow down to the specific tariff variant that applies.

​
Tariff Characteristics

Chosen vs. Imposed

  • Chosen tariffs: Selected by end users (typically retailer tariffs)
  • Imposed tariffs: Automatically applied based on location (typically DSO tariffs, taxes, and fees)

The API returns both types when relevant to a location.

Multiple Tariffs

End users typically have:

  • One tariff from each relevant retailer
  • One tariff from their local DSO
  • Multiple applicable tariffs from tax authorities

The total electricity price combines all applicable tariffs.

Pricing Models

Tariffs may use different pricing structures:

  • Fixed: Consistent prices regardless of time
  • Variable: Prices that change based on predefined schedules
  • Spot-based: Prices that follow wholesale market prices
  • Capacity-based: Prices based on connection capacity or maximum usage

Time Validity

Tariffs have validity periods:

  • Start dates when they become active
  • Optional end dates when they expire
  • Some tariffs may be superseded by newer versions

Use the valid_at parameter to find tariffs active at a specific time.

​
Retrieving Tariffs

The tariffs endpoint requires at minimum a country code and either an organization ID or main tariff ID:

# Get tariffs for a specific organization
GET /tariffs/?country=SE&organization=org_123

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

The tariffs endpoint always requires a country code and either an organization ID or main tariff ID.

​
Location-Based Filtering

You can also filter tariffs by location to find only those applicable to a specific address:

# Get tariffs for an organization at a specific location
GET /tariffs/?country=DK&organization=org_123&address=Rådhuspladsen 1, Copenhagen

​
Tariff Filters

Tariffs often have variations based on different criteria. The API can return filter information to help end users select the correct tariff variant.

​
Example of how filters can be linked to tariffs:

​
Requesting Filter Information

Include the include_filters=true parameter to get filter information with tariffs:

GET /tariffs/?country=SE&organization=org_123&include_filters=true

​
Example Filter Types

​
Filtering by Options

After identifying available filters, you can use the filter_options parameter to find tariffs matching specific criteria:

# Find fixed-price tariffs with 20A fuse
GET /tariffs/?country=SE&organization=org_123&filter_options=tfo_5,tfo_22

​
Tariff Response Structure

When using include_filters=true, the API returns both filters and tariff results:

{
  "context": {
    "organization_id": "org_123",
    "organization_name": "Stockholm Energy Retail",
    "organization_type": "RET"
  },
  "filters": [
    {
      "filter_id": "tf_1",
      "filter_name": "Contract Type",
      "filter_description": "Type of pricing contract",
      "filter_options": [
        {"option_id": "tfo_1", "option_name": "Fixed"},
        {"option_id": "tfo_2", "option_name": "Variable"},
        {"option_id": "tfo_3", "option_name": "Hourly"}
      ],
      "default_option": "tfo_1"
    },
    {
      "filter_id": "tf_2",
      "filter_name": "Housing Type",
      "filter_description": "Type of residence",
      "filter_options": [
        {"option_id": "tfo_4", "option_name": "Apartment"},
        {"option_id": "tfo_5", "option_name": "House"}
      ],
      "default_option": null
    }
  ],
  "results": [
    {
      "id": "tar_789",
      "name": "Residential Fixed Price",
      "observations": "12-month fixed price contract",
      "main_tariff": "mta_456",
      "assigned_options": ["tfo_1", "tfo_4"]
    },
    {
      "id": "tar_790",
      "name": "House Fixed Price",
      "observations": "12-month fixed price for houses",
      "main_tariff": "mta_456",
      "assigned_options": ["tfo_1", "tfo_5"]
    }
  ]
}

​
Using Tariff IDs

Once you’ve identified the correct tariffs, use their IDs with other endpoints:

Current Prices

Get real-time pricing with the /live/ endpoint:

GET /live/?country=SE&tariff_id=tar_123&tariff_id=tar_456&address=Stockholm

Calculate Costs

Calculate costs for specific consumption with the /calculate/ endpoint:

POST /calculate/
{
  "country": "SE",
  "tariff_id": ["tar_123", "tar_456"],
  "address": "Stockholm",
  "kwh_consumed": [...]
}

To provide a complete electricity price, typically include at least one tariff from each relevant organization type (DSO, retailer, taxes).

Always use tariffs that are actually applicable to your location. Using incorrect tariffs will result in inaccurate pricing calculations.