Spark.SmartCharging.Api (1.0)
Download OpenAPI specification:Download
GetSpotPrices
Returns spot prices as set by Nord Pool.
Authorizations:
Bearer
path Parameters
priceArea required | string |
query Parameters
Currency | string (Currency) Enum: "EUR" "NOK" "SEK" "DKK" |
EnergyUnit | string (EnergyUnit) Enum: "kWh" "MWh" |
VATRate | number <double> |
TimeZone | string Default: "Europe/Amsterdam" |
Responses
Response samples
- 200
- 400
- 401
Content type
application/json
{- "priceArea": "string",
- "priceUnits": {
- "currency": "EUR",
- "vat": {
- "rate": 0,
- "hasVAT": true
}, - "energyUnit": "kWh"
}, - "prices": {
- "property1": 0,
- "property2": 0
}
}
GetSpotPricesAdvice
Returns spot prices as set by Nord Pool, including price and cost advice depending on user, partner and/or overridden configuration parameters.
Authorizations:
Bearer
path Parameters
priceArea required | string |
Request Body schema: application/json
object (PriceUnitsParameters) | |
object (ChargingSessionParameters) | |
object (TimeZoneParameters) | |
startFrom | string or null <date-time> |
Responses
Request samples
- Payload
Content type
application/json
{- "priceUnitsParameters": {
- "currency": "EUR",
- "energyUnit": "kWh",
- "vatRate": null
}, - "chargingSessionParameters": {
- "powerInKiloWatts": 3.6,
- "duration": "04:00:00"
}, - "timeZoneParameters": {
- "timeZone": "Europe/Amsterdam"
}, - "startFrom": "2019-08-24T14:15:22Z"
}
Response samples
- 200
- 400
- 401
Content type
application/json
{- "advice": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z",
- "type": "Unknown",
- "cost": 0,
- "averagePrice": 0
}
], - "spotPrices": [
- {
- "time": "2019-08-24T14:15:22Z",
- "price": 0
}
], - "priceArea": "string",
- "priceUnits": {
- "currency": "EUR",
- "vat": {
- "rate": 0,
- "hasVAT": true
}, - "energyUnit": "kWh"
}, - "chargingSession": {
- "powerInKiloWatts": 0,
- "duration": "04:00:00"
}
}
GetForecast
Returns price forecast for the next seven days in blocks of at least 3 hours. The block size can be any multiple of 24 and defaults to 6. Uses actual spot price data from Nord Pool where available.
Authorizations:
Bearer
path Parameters
priceArea required | string |
query Parameters
Currency | string (Currency) Enum: "EUR" "NOK" "SEK" "DKK" |
EnergyUnit | string (EnergyUnit) Enum: "kWh" "MWh" |
VATRate | number <double> |
SegmentSize | integer <int32> Default: 6 |
TimeZone | string Default: "Europe/Amsterdam" |
Responses
Response samples
- 200
- 400
- 401
Content type
application/json
{- "priceArea": "string",
- "priceUnits": {
- "currency": "EUR",
- "vat": {
- "rate": 0,
- "hasVAT": true
}, - "energyUnit": "kWh"
}, - "segmentOptions": {
- "segmentSize": 0
}, - "forecastSegments": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z",
- "averagePrice": 0,
- "dataSource": "Unknown"
}
]
}
GetPriceForecastWithAdvice
Returns price forecast for the next seven days in blocks og at least 3 hours, including price and cost advice depending on user, partner and/or overridden configuration parameters. The block size can be any multiple of 24 and defaults to 6. Uses actual spot price data from Nord Pool where available.
Authorizations:
Bearer
path Parameters
priceArea required | string |
Request Body schema: application/json
object (PriceUnitsParameters) | |
object (SegmentOptionsParameters) | |
object (TimeZoneParameters) |
Responses
Request samples
- Payload
Content type
application/json
{- "priceUnitsParameters": {
- "currency": "EUR",
- "energyUnit": "kWh",
- "vatRate": null
}, - "segmentOptionsParameters": {
- "segmentSize": 6
}, - "timeZoneParameters": {
- "timeZone": "Europe/Amsterdam"
}
}
Response samples
- 200
- 400
- 401
Content type
application/json
{- "priceArea": "string",
- "priceUnits": {
- "currency": "EUR",
- "vat": {
- "rate": 0,
- "hasVAT": true
}, - "energyUnit": "kWh"
}, - "segmentOptions": {
- "segmentSize": 0
}, - "forecastAdvice": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z",
- "averagePrice": 0,
- "dataSource": "Unknown",
- "loss": 0,
- "type": "Normal"
}
]
}