Quickstart
This guide will get you set up with the Enhub API. We'll cover how to authenticate and make your first API request.
Before you can make requests to the API, you will need an API key. See Authentication for how to obtain one.
Making your first scan
Once you have your API key, you can submit a solar scan. The example below creates a scan for a location in Amsterdam with 10 new solar panels:
curl -X POST https://api.enhub.nl/v1/scans \
-H "x-api-key: {your-api-key}" \
-H "Content-Type: application/json" \
-d '{
"location": {
"lat": 52.3676,
"lon": 4.9041
},
"yearlyKwh": 3500,
"inputMethod": "known",
"newPv": [
{
"maxPanelCount": 10,
"name": "new_pv_1",
"minPanelCount": 0,
"panelPowerWatts": 400,
"tiltAngle": 35,
"orientationAngle": 180,
"costPerKwp": 0.01,
"systemLosses": 14
}
],
"tariff": {
"type": "dynamic"
},
"goal": "self-sufficiency"
}'
The API returns a scan status with an id you can use to poll for results:
Response
{
"id": "cm...",
"status": "processing",
"createdAt": "2026-03-11T12:00:00.000Z"
}
Use GET /v1/scans/:id/status to check when the scan is complete, then GET /v1/scans/:id to retrieve the full report.