GET
/
subscriptions
/
{subscription}
/
prices
curl --request GET \
  --url https://api.nomos.energy/subscriptions/{subscription}/prices \
  --header 'Authorization: Bearer <token>'
{
  "object": "prices",
  "subscription": "sub_ze28zs8xh9am05g65f05dnj7",
  "period": {
    "start": "2024-01-31T00:00:00Z",
    "end": "2024-01-31T23:59:59Z"
  },
  "currency": "EUR",
  "unit": "ct/kWh",
  "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

​
subscription
string
required

ID of the subscription to retrieve prices for

Example:

"sub_a05fl82x36f6endetxm8rrra"

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:

"2024-01-31"

​
end
string
required

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

Example:

"2024-01-31"

Response

200
application/json
Successful response
​
object
string
required

Type of object is always prices.

Example:

"prices"

​
subscription
string
required

ID of the subscription these prices are for.

​
period
object
required
​
currency
string
required

Currency of the price amounts.

​
unit
string
required

Unit of the price amounts.

​
resolution
enum<string>
required

Time resolution of the price data points.

Available options:
15min,
60min
​
reference
string
required

Reference market for electricity prices.

​
items
object[] | null
required

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

Create a Subscription