Complete documentation of all API endpoints consumed by the Hello Smart Home Assistant integration. These endpoints are reverse-engineered from the Smart mobile app APKs (EU and INTL variants) and validated against the live API.
| Document | Description |
|---|---|
| Common Patterns | Base URLs, request signing, response envelope, error codes, command controls |
| Endpoint Index | Quick-reference table for all 22+ endpoints |
| Data Models | Enumerations, dataclasses, and type definitions |
| Entity Mapping | How API data maps to Home Assistant entities |
- List Vehicles —
GET /device-platform/user/vehicle/secure - Select Vehicle —
POST /device-platform/user/session/update
- Full Vehicle Status —
GET /remote-control/vehicle/status/{vin} - SOC / Charging Detail —
GET /remote-control/vehicle/status/soc/{vin} - Vehicle Running State —
GET /remote-control/vehicle/status/state/{vin}
- Telematics Status —
GET /remote-control/vehicle/telematics/{vin} - Diagnostic History —
GET /remote-control/vehicle/status/history/diagnostic/{vin}
- Charging Reservation —
GET /remote-control/charging/reservation/{vin} - Climate Schedule —
GET /remote-control/schedule/{vin}
- Mini-Fridge Status —
GET /remote-control/getFridge/status/{vin} - Locker Status —
GET /remote-control/getLocker/status/{vin} - Locker Secret —
GET /remote-control/locker/secret/{vin} - Fragrance System —
GET /remote-control/vehicle/fragrance/{vin}
- VTM Settings —
GET /remote-control/getVtmSettingStatus - Geofences —
GET /geelyTCAccess/tcservices/vehicle/geofence/all/{vin}
- Trip Journal V4 —
GET /geelyTCAccess/.../journalLogV4/{vin} - Total Distance —
GET /geelyTCAccess/.../getTotalDistanceByLabel/{vin}
- Capabilities —
GET /geelyTCAccess/tcservices/capability/{vin} - Energy Ranking —
GET /geelyTCAccess/.../ranking/.../vehicleModel/{vin} - Factory Plant Number —
GET /geelyTCAccess/.../plantNo/{vin}
- OTA Info —
GET https://ota.srv.smart.com/app/info/{vin} - FOTA Notification —
GET /fota/geea/assignment/notification