# Tellus Power

## Docs

- [Fetch pending command (long polling)](https://developers.telluspowergroup.com/api-reference/charger-—-commands/fetch-pending-command-long-polling.md): The charger polls for pending commands using long polling. If no command is available, the request hangs until the timeout expires (default 30 seconds, max 60) or a command arrives.
- [Report command status](https://developers.telluspowergroup.com/api-reference/charger-—-commands/report-command-status.md): Reports the execution result of a previously received command.
- [Firmware upgrade status](https://developers.telluspowergroup.com/api-reference/charger-—-firmware/firmware-upgrade-status.md): The charger reports firmware-upgrade progress or final result.
- [Obtain charger access token](https://developers.telluspowergroup.com/api-reference/charger-—-provisioning/obtain-charger-access-token.md): Exchange `device_id` + `device_secret` for a temporary Bearer token.
- [Register a charger](https://developers.telluspowergroup.com/api-reference/charger-—-provisioning/register-a-charger.md): Called when a charger connects to the platform for the first time. Returns `device_id` and `device_secret` which are then used to obtain temporary access tokens via `/v1/device/token`.
- [Charging-record upload](https://developers.telluspowergroup.com/api-reference/charger-—-reporting/charging-record-upload.md): After a charging session ends, the charger uploads the complete charging record (CDR).
- [Event reporting](https://developers.telluspowergroup.com/api-reference/charger-—-reporting/event-reporting.md): Reports device events such as plug-in, plug-out, charging start / stop, faults, and alarms.
- [Heartbeat](https://developers.telluspowergroup.com/api-reference/charger-—-reporting/heartbeat.md): Periodic (e.g., every 30 seconds) report from the charger of online status. The response may include pending commands queued for the device.
- [Real-time telemetry upload](https://developers.telluspowergroup.com/api-reference/charger-—-reporting/real-time-telemetry-upload.md): Periodic upload of real-time electrical telemetry (typically every 5 seconds during charging or discharging). Supports single-phase and three-phase via the optional `phase_details` block.
- [Batch device-status query (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/batch-device-status-query-legacy.md): Legacy interface (§5). Batch query of real-time status for up to 50 devices.
- [Notify station status change (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/notify-station-status-change-legacy.md): Legacy push interface (§4). Implemented by the data-demander platform and called by the charging operator when device status changes.
- [Push work status (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/push-work-status-legacy.md): Legacy interface (§7). Implemented by the customer platform and called by the device operator after a charge starts or fails. Retry policy: 5 attempts at intervals of 1m, 5m, 60m, 180m, 24h. After exhaustion, the customer can call `query_station_status` to fetch state.
- [Query charge-point information (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/query-charge-point-information-legacy.md): Legacy interface (§3 of the v1.3 spec). Implemented by the charging operator and called by a peer "data-demander" platform. PascalCase request and response fields, PUT method.
- [Start charging (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/start-charging-legacy.md): Legacy interface (§6). Implemented by the device operator and called by the customer platform. Response time SHOULD NOT exceed 3 seconds.
- [Start discharging (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/start-discharging-legacy.md): Legacy V2G start interface (§9). Response time SHOULD NOT exceed 3 seconds.
- [Stop charging (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/stop-charging-legacy.md): Legacy interface (§8). Response time SHOULD NOT exceed 1 second.
- [Stop discharging (legacy)](https://developers.telluspowergroup.com/api-reference/operator-to-operator-legacy-interop/stop-discharging-legacy.md): Legacy interface (§10).
- [Obtain an operator access token](https://developers.telluspowergroup.com/api-reference/operator-—-authentication/obtain-an-operator-access-token.md): Exchange `client_id` and `client_secret` for a Bearer access token. Tokens are valid for 24 hours (86,400 seconds).
- [Query charging records](https://developers.telluspowergroup.com/api-reference/operator-—-charging-records/query-charging-records.md): Retrieves historical charging records, optionally filtered by device, connector, or time range.
- [Get command status](https://developers.telluspowergroup.com/api-reference/operator-—-commands/get-command-status.md): Retrieves the execution status of a previously issued command (e.g., from a remote-start, stop, discharge, schedule, or flexibility call).
- [Aggregated energy data](https://developers.telluspowergroup.com/api-reference/operator-—-energy-&-flexibility/aggregated-energy-data.md): Returns aggregated energy metrics (charge / discharge / max power / avg power) over a specified time period, optionally grouped by site.
- [Load flexibility control](https://developers.telluspowergroup.com/api-reference/operator-—-energy-&-flexibility/load-flexibility-control.md): Sends a load-control command to a group of chargers (e.g., reduce power by 50% across an entire site, or pause all charging for 10 minutes for grid-balancing purposes).
- [Remote discharge (V2G)](https://developers.telluspowergroup.com/api-reference/operator-—-remote-control/remote-discharge-v2g.md): Initiates vehicle-to-grid discharging on a connector. Only valid for V2G-capable hardware.
- [Remote start charging](https://developers.telluspowergroup.com/api-reference/operator-—-remote-control/remote-start-charging.md): Remotely start charging on a specific connector.
- [Remote stop charging](https://developers.telluspowergroup.com/api-reference/operator-—-remote-control/remote-stop-charging.md)
- [Set charging schedule](https://developers.telluspowergroup.com/api-reference/operator-—-remote-control/set-charging-schedule.md): Stores a scheduled charging plan on the connector. The charger executes the schedule autonomously, even without continuous platform connectivity.
- [Get charger details](https://developers.telluspowergroup.com/api-reference/operator-—-sites-&-devices/get-charger-details.md): Retrieves detailed information about a specific charger, including connector states.
- [List sites](https://developers.telluspowergroup.com/api-reference/operator-—-sites-&-devices/list-sites.md): Retrieves a list of sites accessible to the authenticated client.
- [Real-time telemetry stream (WebSocket)](https://developers.telluspowergroup.com/api-reference/operator-—-telemetry-stream-websocket/real-time-telemetry-stream-websocket.md): **WebSocket endpoint.** Connect to `wss://<base>/v1/operator/stream?devices=<comma-separated device_ids>` with the access token in the `Authorization` header during the WebSocket handshake (or as a `?token=...` query parameter).
- [Fault dictionary](https://developers.telluspowergroup.com/diagnostics/fault-dictionary.md): Reference for fault codes raised by Tellus chargers — symptoms, likely causes, diagnostic steps, related telemetry, and firmware-specific known issues.
- [Proposed extensions](https://developers.telluspowergroup.com/diagnostics/proposed-extensions.md): API extensions to the v1.3 specification proposed for upcoming releases — component-level telemetry, remote diagnostic commands, OCPP version metadata, and service-account authentication.
- [Diagnostic runbooks](https://developers.telluspowergroup.com/diagnostics/runbooks.md): Step-by-step playbooks for the most common diagnostic situations encountered with Tellus chargers — written for field engineers and partner tech teams.
- [Authentication](https://developers.telluspowergroup.com/guides/authentication.md): OAuth2 client-credentials for operator integrations, bearer-token auth for chargers, and the patterns Tellus recommends for production deployments.
- [Coexisting with OCPP](https://developers.telluspowergroup.com/guides/coexistence-with-ocpp.md): How the Tellus Open Platform API runs alongside your existing OCPP-based CPMS — entirely under customer control, with clear data-sovereignty guarantees.
- [Errors](https://developers.telluspowergroup.com/guides/errors.md): Error envelope, complete error code table, and recommended retry strategies.
- [Rate Limits](https://developers.telluspowergroup.com/guides/rate-limits.md): Request quotas for operator and charger endpoints, and how to design your client to stay within them.
- [Tellus Power Open Platform](https://developers.telluspowergroup.com/index.md): Build on the open API behind Tellus Power's global charging infrastructure — OCPP-aligned, V2G-ready, partner-grade.
- [Quickstart](https://developers.telluspowergroup.com/quickstart.md): Authenticate, list your sites, and make your first request to the Tellus Open Platform API in under five minutes.

## OpenAPI Specs

- [openapi](https://developers.telluspowergroup.com/api-reference/openapi.json)