API Documentation

GET/ api / model

AI BESS Schedule

Generate an optimal schedule for your Battery Energy Storage System(BESS) based on day - ahead prices and system parameters.

Query - Parameter

AttributTypDescriptionExample
datestringdate(YYYY-MM-DD)2025 - 04 - 23
locationstringcountryAustria
powerstringpower(MW)10
capacitystringcapacity(MWh)100
efficiencystringefficiency(0-1)0.8

Example - Request

curl -G http://https://bess-optimizer-backend.app-nest.cloud/api/model \
  --data-urlencode 'date=2025-04-23' \
  --data-urlencode 'location=Austria' \
  --data-urlencode 'power=10' \
  --data-urlencode 'capacity=100' \
  --data-urlencode 'efficiency=0.8'

Example - Response

{
  "date": "2025-04-23",
  "prices": [45.2, 44.8, ...],
  "policies": ["charge", "idle", ...],
  "soc": [50.0, 55.0, ...],
  "in_out": [0.0, 10.0, ...],
  "profit": 1234.56
}

Error Codes

StatusDescription
400Invalid parameters
401API key missing or invalid
415Content - Type not supported
500Internal server error