Skip to main content
POST
/
cost-of-energy
/
v1
/
calculate
Calculate Tariff
curl --request POST \
  --url https://api.engrate.io/cost-of-energy/v1/calculate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "datasets": [
    {
      "data": [
        {
          "timestamp": "2026-01-01T00:00:00+01:00",
          "value": 1.5
        },
        {
          "timestamp": "2026-01-01T00:15:00+01:00",
          "value": 1.2
        }
      ],
      "name": "quarter-hourly-energy-offtake"
    }
  ],
  "end_time": "2026-01-01T00:30:00+01:00",
  "start_time": "2026-01-01T00:00:00+01:00",
  "tariff_id": "123e4567-e89b-12d3-a456-426614174000"
}
'
{
  "components": [
    {
      "applicable_from": "2026-01-01T00:00:00+01:00",
      "datasets": [
        {
          "data": [
            {
              "timestamp": "2026-01-01T00:00:00+01:00",
              "value": 1.5
            },
            {
              "timestamp": "2026-01-01T00:15:00+01:00",
              "value": 1.2
            }
          ],
          "name": "quarter-hourly-energy-offtake"
        },
        {
          "data": [
            {
              "timestamp": "2026-01-01T00:00:00+01:00",
              "value": 0.54
            },
            {
              "timestamp": "2026-01-01T00:15:00+01:00",
              "value": 0.432
            }
          ],
          "name": "cost"
        }
      ],
      "name": "Energiskatt"
    }
  ]
}

Authorizations

Authorization
string
header
required

Body

application/json
datasets
Dataset · object[]
required
end_time
string<date-time>
required
start_time
string<date-time>
required
tariff_id
string<uuid>
required

Response

Successful Response

components
CalculateComponentResult · object[]
required