GET
/
subscriptions
/
{id}
/
prices
curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/prices \
  --header 'Authorization: Bearer <token>'
{
  "object": "price",
  "subscription": "sub_rocbrf1u5e48mm0reeqoag90",
  "period": {
    "start": "2025-04-01",
    "end": "2025-04-01"
  },
  "unit": "ct/kWh",
  "currency": "EUR",
  "resolution": "60min",
  "reference": "EPEX Day-Ahead Hourly",
  "items": [
    {
      "timestamp": "2024-01-31T00:00:00Z",
      "amount": 24.44,
      "components": [
        {
          "type": "electricity",
          "amount": 8.77
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 6.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T01:00:00Z",
      "amount": 22.15,
      "components": [
        {
          "type": "electricity",
          "amount": 7.48
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T02:00:00Z",
      "amount": 20.88,
      "components": [
        {
          "type": "electricity",
          "amount": 6.21
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T03:00:00Z",
      "amount": 19.97,
      "components": [
        {
          "type": "electricity",
          "amount": 5.3
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T04:00:00Z",
      "amount": 21.56,
      "components": [
        {
          "type": "electricity",
          "amount": 6.89
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    }
  ]
}

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_rocbrf1u5e48mm0reeqoag90"

​
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).

Example:
[
  {
    "timestamp": "2024-01-31T00:00:00Z",
    "amount": 24.44,
    "components": [
      { "type": "electricity", "amount": 8.77 },
      { "type": "grid", "amount": 9.47 },
      { "type": "levies", "amount": 6.2 }
    ]
  },
  {
    "timestamp": "2024-01-31T01:00:00Z",
    "amount": 22.15,
    "components": [
      { "type": "electricity", "amount": 7.48 },
      { "type": "grid", "amount": 9.47 },
      { "type": "levies", "amount": 5.2 }
    ]
  },
  {
    "timestamp": "2024-01-31T02:00:00Z",
    "amount": 20.88,
    "components": [
      { "type": "electricity", "amount": 6.21 },
      { "type": "grid", "amount": 9.47 },
      { "type": "levies", "amount": 5.2 }
    ]
  },
  {
    "timestamp": "2024-01-31T03:00:00Z",
    "amount": 19.97,
    "components": [
      { "type": "electricity", "amount": 5.3 },
      { "type": "grid", "amount": 9.47 },
      { "type": "levies", "amount": 5.2 }
    ]
  },
  {
    "timestamp": "2024-01-31T04:00:00Z",
    "amount": 21.56,
    "components": [
      { "type": "electricity", "amount": 6.89 },
      { "type": "grid", "amount": 9.47 },
      { "type": "levies", "amount": 5.2 }
    ]
  }
]