Endpoints - Min Strøm API

Base URL

The Min Strøm API is accessed through the following base URL:

https://api.minstroem.app/thirdParty

Spot prices

Get the future hourly electricity spot prices excl. charges.

GET /prices/{region}


`region`	String	Required	See 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"
    }
]

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}


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The 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"
    }
]

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}


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The 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"
    }
]

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}


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

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


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

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


`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


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

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


`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.

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


`region`	String	Required	See Regions for possible values

[
    {
        "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 info

Get full charges information for a specific location and date

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


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude
`date`	Date	Required	ISO8601 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
        }
    ]
}

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price validity
`address`	String	Optional	The total electricity price for that hour, but only spot price if charges are unavailable.
`subscriptions`	Array	Required	A list of all applicable subscriptions
`tariffs`	Array	Required	A list of all applicable tariffs

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

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

​Base URL

​Spot prices

​Full prices (incl. charges)

​Search address

​Get prices for address

​Grant access

​List addresses

​Get prices for address

​Forecast spot prices

​Charges info

​Request count

Base URL

Spot prices

Full prices (incl. charges)

Search address

Get prices for address

Grant access

List addresses

Get prices for address

Forecast spot prices

Charges info

Request count