## 💬 New Discussion: Good API Calls for Smappee API Integrations

[myny-git]

💬 New Discussion: Good API Calls for Smappee API Integrations

Hi everyone,

I'd like to start a thread where we can share useful Smappee API endpoints that you've successfully used in your projects or integrations. The goal is to create a reference point for those working on Home Assistant or other integrations with Smappee.
This is the link to the general API document.

📘 Get Smart Devices – API Docs

1. Get your smartdeviceID using:
   GET /servicelocation/[SERVICELOCATIONID]/smartdevices

2. Then inspect the full structure:
   GET /servicelocation/[SERVICELOCATIONID]/smartdevices/[SMARTDEVICEID]

You’ll find properties like:

{
  "id": "CARCHARGER-XXX",
  "uuid": "XXXXX",
  "name": "XXX",
  "type": {...},
  "configurationProperties": [...],
  "properties": [...]
}

3. Use POST calls with UUID to control the charger:

• startCharging (w/ percentageLimit)
• stopCharging
• pauseCharging
• smartChargingMode
• normalChargingMode
• setChargingMode (mode = STANDARD | SMART | SOLAR)
• setPercentageLimit

🔄 Periodic State Updates

• GET /servicelocation/{id}/smartdevices/{smart_device_id}
  → To retrieve the current chargingState from the smart device.

• GET /servicelocation/{id}/smartdevices
  → To fetch led_brightness from the configurationProperties.

⚙️ Actions via UUID

These are triggered via the smart_device_uuid, and executed using POST:

• /actions/setChargingMode
• /actions/startCharging (with percentageLimit)
• /actions/pauseCharging
• /actions/stopCharging
• /actions/setBrightness (with brightness integer value)
• /actions/setAvailable
• /actions/setUnavailable

---

If you’ve discovered other endpoints, tricks, or edge cases, feel free to drop them below. Let’s build a shared reference for advanced Smappee integrations! ⚡

[myny-git]

Ok, the original @gvnuland repo also had the session state

curl -X GET https://app1pub.smappee.net/dev/v3/chargingstations/YOURSERIAL/sessions?range=1635721200000
-H "Authorization: Bearer YOURBEARER"
-H "Content-Type: application/json"

You receive a list of charging sessions.
I just copy here the first ones:

[{
    "id": 19005307,
    "serialNumber": "OBFUSCATED",
    **"connector": 1,**
    "from": 1754990403,
    "to": 1755013216,
    **"status": "STOPPED",**
    "suspendedByUser": true,
    **"smartMode": "CHARGE_NOW",**
    "priority": 0,
    "minimumExcessPercentage": 100,
    "maxAmperes": [12.0, 12.0, 12.0],
    "startReading": 1409.042,
    "stopReading": 1433.879,
    **"energy": 24.837**
}, {
    "id": 18975730,
    "serialNumber": "OBFUSCATED",
    "connector": 1,
    "from": 1754909752,
    "to": 1754935555,
    "status": "STOPPED",
    "suspendedByUser": true,
    "smartMode": "SMART_CHARGING_SCHEDULE_FOLLOWED_BY_EXCESS_ONLY",
    "priority": 0,
    "minimumExcessPercentage": 100,
    "maxAmperes": [0.0, 0.0, 0.0],
    "startReading": 1395.166,
    "stopReading": 1409.01,
    "energy": 13.844
}, {
    "id": 18975615,

Some interesting data:

• The current status --> STOPPED in this case (there is no car attached). (our state in the home assistant is currently SUSPENDED)
• Connector ID
• smartMode, the mode you used (I believe lastly)
• the energy --> this gives you the energy which you charged the car in current session

Would this be interesting to get all this data? For now, the EVCC seems to work, and EVCC also calculates the energy. Maybe there is a simple way via MODBUS to also get the energy per session.

It would be interesting to see how the status and from/to are changing during charging. If someone can do this. My car is now full ;-)
Also how the json list is set up with 2 connectors.

What would/could we use this for?