GET
/
subscriptions
/
{id}
/
prices
curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/prices \
  --header 'Authorization: Bearer <token>'
{
  "object": "price",
  "subscription": "sub_1",
  "period": {
    "start": "2021-01-01",
    "end": "2021-01-01"
  },
  "unit": "ct/kWh",
  "currency": "EUR",
  "resolution": "60min",
  "reference": "EPEX Day-Ahead Hourly",
  "items": [
    {
      "timestamp": "<string>",
      "amount": 123,
      "components": [
        {
          "type": "electricity",
          "amount": 123
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required
Example:

"sub_1"

Query Parameters

​
start
string
required

Start date of the period at 00:00:00 in local time of the customer (format yyyy-mm-dd)

Example:

"2025-02-01"

​
end
string
required

End date of the period at 23:59:59 in local time of the customer (format yyyy-mm-dd)

Example:

"2025-02-01"

Response

200
application/json
Retrieve the price details
​
object
enum<string>
required
Available options:
price
​
subscription
string
required

The id of the subscription

Example:

"sub_1"

​
period
object
required
​
unit
string
required

The unit of the price

Example:

"ct/kWh"

​
currency
string
required

The currency of the price

Example:

"EUR"

​
resolution
enum<string>
required

The time resolution of the price data points

Available options:
60min,
15min
Example:

"60min"

​
reference
string
required

Reference market for electricity prices

Example:

"EPEX Day-Ahead Hourly"

​
items
object[] | null
required

List of price data points. Null if subscription is not active (either hasn't started yet or has ended).