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.
- Common Patterns — Base URLs, request signing, response envelope, error codes, command controls
| Endpoint | Method | Description |
|---|---|---|
| EU Login (Gigya) | POST | Multi-step OAuth via Gigya identity provider |
| INTL Login (3-Step) | POST | Direct login flow for international regions |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| List Vehicles | GET | /device-platform/user/vehicle/secure |
Fetch all linked vehicles |
| Select Vehicle | POST | /device-platform/user/session/update |
Set active vehicle for session |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Full Vehicle Status | GET | /remote-control/vehicle/status/{vin} |
Battery, doors, windows, tyres, GPS, climate |
| SOC / Charging Detail | GET | /remote-control/vehicle/status/soc/{vin} |
Voltage, current, time to full |
| Vehicle Running State | GET | /remote-control/vehicle/status/state/{vin} |
Power mode, speed |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Telematics Status | GET | /remote-control/vehicle/telematics/{vin} |
Connectivity, backup battery |
| Diagnostic History | GET | /remote-control/vehicle/status/history/diagnostic/{vin} |
Recent DTCs |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Charging Reservation | GET | /remote-control/charging/reservation/{vin} |
Scheduled charging config |
| Climate Schedule | GET | /remote-control/schedule/{vin} |
Climate pre-conditioning schedule |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Mini-Fridge Status | GET | /remote-control/getFridge/status/{vin} |
Fridge on/off, temp, mode |
| Locker Status | GET | /remote-control/getLocker/status/{vin} |
Storage locker open/locked |
| Locker Secret | GET | /remote-control/locker/secret/{vin} |
Locker PIN configuration |
| Fragrance System | GET | /remote-control/vehicle/fragrance/{vin} |
Fragrance diffuser status |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| VTM Settings | GET | /remote-control/getVtmSettingStatus |
Vehicle Theft Monitoring config |
| Geofences | GET | /geelyTCAccess/tcservices/vehicle/geofence/all/{vin} |
All configured geofences |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Trip Journal V4 | GET | /geelyTCAccess/tcservices/vehicle/status/journalLogV4/{vin} |
Trip data with energy metrics |
| Total Distance | GET | /geelyTCAccess/tcservices/vehicle/status/getTotalDistanceByLabel/{vin} |
Cumulative odometer |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Vehicle Ability | GET | /vehicle/v1/ability/{modelCode}/{vin} |
Remote capabilities, color-matched images (different host) |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Capabilities | GET | /geelyTCAccess/tcservices/capability/{vin} |
Feature flags / enabled services |
| Energy Ranking | GET | /geelyTCAccess/.../ranking/aveEnergyConsumption/vehicleModel/{vin} |
Consumption ranking |
| Factory Plant Number | GET | /geelyTCAccess/tcservices/customer/vehicle/plantNo/{vin} |
Factory identification |
| Endpoint | Method | Path | Description |
|---|---|---|---|
| OTA Info | GET | https://ota.srv.smart.com/app/info/{vin} |
Firmware versions (different host) |
| FOTA Notification | GET | /fota/geea/assignment/notification |
Pending update notifications |
| Service | Method | Service ID | Description |
|---|---|---|---|
| Door Lock | PUT | RDL_2 |
Lock all doors |
| Door Unlock | PUT | RDU_2 |
Unlock all doors |
| Climate Start/Stop | PUT | RCE_2 |
HVAC pre-conditioning |
| Seat Heating | PUT | RSH |
Set seat heater level |
| Seat Ventilation | PUT | RSV |
Set seat vent level |
| Horn & Lights | PUT | RHL |
Horn, flash, find my car |
| Window Close | PUT | RWS_2 |
Close all windows |
| Charging Start/Stop | PUT | rcs |
Start or stop charging |
| Mini-Fridge | PUT | UFR |
Fridge on/off |
| Fragrance | PUT | RFD_2 |
Fragrance diffuser on/off |
| Vehicle Tracking | PUT | VTM |
VTM on/off |
| Locker | PUT | RPC |
Lock/unlock storage locker |
All commands are sent via
PUT /remote-control/vehicle/telematics/{vin}. See Command Controls for payload structure and parameters.
- Data Models — Enumerations, dataclasses, and type definitions
- Entity Mapping — How API data maps to Home Assistant entities
- APK API Audit — Complete endpoint inventory from decompiled EU & INTL APKs (~360 endpoints each, with diff flags)