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}

Parameters


`region`	String	Required	See Regions for possible values

Response

[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 2.04095,
        "color": "yellow"
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 3.6294125,
        "color": "yellow"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`color`	String	Optional	The 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.

Coordinate lookup - Using lat/long to look up charges
Address lookup - Using a free text address query to look up charges
Eloverblik (for private consumers) - Using MitID to get household charges

One of the easiest ways to get prices including charges.

GET /prices/location?latitude={latitude}&longitude={longitude}

Parameters


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude

Response

[
    {
        "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"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`charges`	Double	Optional	The total amount of charges.
`color`	String	Optional	The 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`.

One of the easiest ways to get prices including charges.

GET /prices/location?latitude={latitude}&longitude={longitude}

Parameters


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude

Response

[
    {
        "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"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`charges`	Double	Optional	The total amount of charges.
`color`	String	Optional	The 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`.

If you know the address of the user, this approach is the quickest way to get full electricity prices.

This process consists of 2 steps:

Search addresses

When the end-user has authorized access, you should display the list of addresses associated with the given user, so that they can select which address to get data from.

Get prices for address

You can now request electricity prices incl. all current and applicable charges.

If you already have the DAWA address ID, you can skip Step 1 and go directly to Step 2.

Search address

In order to get prices including charges you first need to get a valid address to make the lookup with.

GET /prices/addresses/suggestions/{query}

Parameters


`query`	String	Required	The free text address query to search for

Response

[
    {
        "id": "645db24a-f11a-3388-e044-0003ba298018",
        "suggestion": "Solbakkevej 11, 2630 Taastrup, 2. tv.",
        "streetName": "Solbakkevej",
        "streetNumber": "11",
        "floor": "2",
        "door": "tv",
        "zipCode": "2630",
        "city": "Taastrup",
    }
]

Parameter	Type		Description
`id`	String	Required	The ID of the address to pass on to subsequent endpoints as parameter
`suggestion`	String	Required	The full text string representation of the address to show to the user
`streetName`	String	Optional	The street name
`streetNumber`	String	Optional	The street number
`floor`	String	Optional	The floor
`door`	String	Optional	The door
`zipCode`	String	Optional	The zip code
`city`	String	Optional	The city

Get prices for address

With a valid address you can now lookup prices including charges (best effort):

GET /prices/addresses/{addressId}

Parameters


`addressId`	String	Required	The address ID returned from the address susgestion endpoint.

Response

[
    {
        "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"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`charges`	Double	Optional	The total amount of charges.
`color`	String	Optional	The 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`.

To get electricity precise prices including all current and applicable charges, the end user must grant access to their household data through the public energy portal Eloverblik.

This process consists of 3 steps:

Grant access

In order to get access to all current and applicable charges for a given household, the end-user must first authorize access. This is achieved by logging in with MitID through Eloverblik.

List addresses

When the end-user has authorized access, you should display the list of addresses associated with the given user, so that they can select which address to get data from.

Get prices for address

You can now request electricity prices incl. all current and applicable charges.

Grant access

Generate an authorization link to present a web view that will allow the user to authorize access to their household data, incl. all charges.

GET /users/{userId}/connectAddress

Parameters


`userId`	String	Required	The ID of the user in your system

This immediately redirects to the authorization page on Eloverblik.dk

Does NOT require authorization header

List addresses

Get all addresses associated to a user.

GET /users/{userId}/connectedAddresses

Parameters


`userId`	String	Required	The ID of the user in your system

Response

[
    {
        "id": "571313174032556653"
        "address": "Æblevej 1A, 2. th.",
        "fullAddress": "Æblevej 1A, 2. th, 2200 København N",
    },
    {
        "id": "571313181101102422"
        "address": "Appelsinvej 243",
        "fullAddress": "Appelsinvej 243, 4200 Slagelse",
    }
]

Parameter	Type		Description
`id`	String	Required	Unique ID of the address. Used to include charges on /prices endpoint.
`address`	String	Required	A short version of the address, suitable to show in UI.
`fullAddress`	String	Required	The full address.

Get prices for address

GET /prices/{region}?addressId={addressId}

Parameters


`region`	String	Required	See Regions for possible values
`addressId`	String	Optional	The ID of a connected address. If available, this will include all charges for the address in the electricity price.

Response

[
    {
        "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"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`charges`	Double	Optional	The total amount of charges.
`color`	String	Optional	The 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

Parameters


`region`	String	Required	See Regions for possible values

Response

[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 1.04095
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 1.6294125
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The 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}

Parameters


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude
`date`	Date	Required	ISO8601 timestamp of the price validity

Response

{
    "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
        }
    ]
}

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price validity
`address`	String	Optional	The address of the location
`subscriptions`	Array	Required	A list of all applicable subscriptions
`tariffs`	Array	Required	A 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}

Parameters

	Type		Description
`latitude`	Double	Required	The latitude of the location
`longitude`	Double	Required	The longitude of the location
`fromDate`	String	Required	ISO8601 timestamp marking the start of the date range (inclusive)
`toDate`	String	Optional	ISO8601 timestamp marking the end of the date range (exclusive). Defaults to the current date/time

Response

{
    "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 ...
    ]
}

Parameter	Type		Description
`from`	String	Required	ISO8601 timestamp marking the start of the period
`to`	String	Optional	ISO8601 timestamp marking the end of the period
`tariffs`	Array	Required	List of tariffs with time intervals
`subscriptions`	Array	Required	List of subscriptions with time intervals

API Usage

Request count

Get the running request count for your account

GET /currentRequestCount

Response

[
    {
        "date": "2024-05-16T22:00:00Z",
        "requestCount": 1257
    },
    {
        "date": "2024-05-17T22:00:00Z",
        "requestCount": 1104
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the day
`requestCount`	Int	Required	The total requests logged for your account on the given `day`

Documentation

Endpoints

Base URL

Prices

Spot prices

Full prices (incl. charges)

Search address

Get prices for address

Grant access

List addresses

Get prices for address

Forecast spot prices

Charges

Hour specific

Historic charges

API Usage

Request count

Documentation

​Base URL

​Prices

​Spot prices

​Full prices (incl. charges)

​Search address

​Get prices for address

​Grant access

​List addresses

​Get prices for address

​Forecast spot prices

​Charges

​Hour specific

​Historic charges

​API Usage

​Request count

Base URL

Prices

Spot prices

Full prices (incl. charges)

Search address

Get prices for address

Grant access

List addresses

Get prices for address

Forecast spot prices

Charges

Hour specific

Historic charges

API Usage

Request count