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

The response is of type object.

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

The response is of type object.