Skip to main content

Base URL

The Min Strøm API is accessed through the following base URL:
https://api.minstroem.app/thirdParty

Prices

Spot prices

Get the future hourly electricity spot prices excl. charges.
GET /prices/{region}
regionStringRequiredSee Regions for possible values
[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 2.04095,
        "color": "yellow"
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 3.6294125,
        "color": "yellow"
    }
]
ParameterTypeDescription
dateStringRequiredISO8601 timestamp of the price interval start
priceDoubleRequiredThe total electricity price for that hour, but only spot price if charges are unavailable.
colorStringOptionalThe suggested color to show along with the price. This is dynamic based on region and whether charges are available or not. Possible values are: green, yellow, red.

Full prices (incl. charges)

There are three overall approaches to get electricity prices including all charges.
  1. Coordinate lookup - Using lat/long to look up charges
  2. Address lookup - Using a free text address query to look up charges
  3. Eloverblik (for private consumers) - Using MitID to get household charges
  • Coordinate lookup
  • Address lookup
  • Eloverblik
One of the easiest ways to get prices including charges.
GET /prices/location?latitude={latitude}&longitude={longitude}
latitudeDoubleRequiredThe latitude
longitudeDoubleRequiredThe longitude
[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 2.04095,
        "charges": 1.4335,
        "color": "yellow"
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 3.6294125,
        "charges": 2.277875,
        "color": "yellow"
    }
]
ParameterTypeDescription
dateStringRequiredISO8601 timestamp of the price interval start
priceDoubleRequiredThe total electricity price for that hour, but only spot price if charges are unavailable.
chargesDoubleOptionalThe total amount of charges.
colorStringOptionalThe suggested color to show along with the price. This is dynamic based on region and whether charges are available or not. Possible values are: green, yellow, red.

Forecast spot prices

Get unconfirmed future hourly electricity prices up to 7 days into the future.
GET /prices/{region}/forecast
regionStringRequiredSee Regions for possible values
[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 1.04095
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 1.6294125
    }
]
ParameterTypeDescription
dateStringRequiredISO8601 timestamp of the price interval start
priceDoubleRequiredThe total electricity price for that hour, but only spot price if charges are unavailable.

Charges

Hour specific

Get full charges information for a specific location and date
GET /prices/charges/location?latitude={latitude}&longitude={longitude}&date={date}
latitudeDoubleRequiredThe latitude
longitudeDoubleRequiredThe longitude
dateDateRequiredISO8601 timestamp of the price validity
{
    "date": "2024-04-19T23:00:00Z",
    "address": "Feldskovvej 1B, 3. mf., 4180 Sorø",
    "subscriptions": [
        {
            "name": "TSO - System Abonnement",
            "ownerName": "Energinet",
            "price": 0.625
        },
        {
            "name": "Net abo C forbrug time",
            "ownerName": "Cerius A/S",
            "price": 2.19791
        }
    ],
    "tariffs": [
        {
            "name": "Transmissions nettarif",
            "ownerName": "Energinet",
            "price": 0.0925
        },
        {
            "name": "Systemtarif",
            "ownerName": "Energinet",
            "price": 0.06375
        },
        {
            "name": "Elafgift",
            "ownerName": "Energinet",
            "price": 0.95125
        },
        {
            "name": "Nettarif C time",
            "ownerName": "Cerius A/S",
          	"price": 0.14075
        }
    ]
}
ParameterTypeDescription
dateStringRequiredISO8601 timestamp of the price validity
addressStringOptionalThe address of the location
subscriptionsArrayRequiredA list of all applicable subscriptions
tariffsArrayRequiredA list of all applicable tariffs

Historic charges

Get historical full charges information for a specific location and date range.
GET /prices/charges/location/history?latitude={latitude}&longitude={longitude}&fromDate={fromDate}&toDate={toDate}
TypeDescription
latitudeDoubleRequiredThe latitude of the location
longitudeDoubleRequiredThe longitude of the location
fromDateStringRequiredISO8601 timestamp marking the start of the date range (inclusive)
toDateStringOptionalISO8601 timestamp marking the end of the date range (exclusive). Defaults to the current date/time
{
    "from": "2025-02-14T21:31:50Z",
    "to": "2025-05-14T21:31:50Z",
    "tariffs": [
        {
            "price": { "static": { "price": 0.9 } },
            "ownerName": "Energinet",
            "name": "Elafgift",
            "from": "2024-12-31T23:00:00Z"
        },
        // ... additional tariff entries ...
    ],
    "subscriptions": [
        {
            "name": "Net abo C forbrug",
            "price": { "static": { "price": 26.686367 } },
            "ownerName": "N1 A/S - 131",
            "from": "2024-12-31T23:00:00Z"
        },
        // ... additional subscription entries ...
    ]
}
ParameterTypeDescription
fromStringRequiredISO8601 timestamp marking the start of the period
toStringOptionalISO8601 timestamp marking the end of the period
tariffsArrayRequiredList of tariffs with time intervals
subscriptionsArrayRequiredList of subscriptions with time intervals

API Usage

Request count

Get the running request count for your account
GET /currentRequestCount
[
    {
        "date": "2024-05-16T22:00:00Z",
        "requestCount": 1257
    },
    {
        "date": "2024-05-17T22:00:00Z",
        "requestCount": 1104
    }
]
ParameterTypeDescription
dateStringRequiredISO8601 timestamp of the day
requestCountIntRequiredThe total requests logged for your account on the given day
I