Maintenance
For installers (Field Service Technicians): one charge station their installer account maintains, as the dashboard shows it to them. Returns identity, operational and connectivity status, Boot Info (vendor, model, serial and box serial numbers, firmware version, SIM IMSI and ICCID, meter type and serial), the customer account, location, installer account, provider, subscription and access groups by name, created / activated / updated dates, the open detected issues in full, and the connectors. No sessions, tariffs, roaming settings, addresses or contact details. Requires maintenance access on the caller's account. A station the installer account does not maintain, or an archived one, is reported as not found, the same as one that does not exist. Use charge-points-status for the live state of the station, such as heartbeat and the last session attempt. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.
Verified customerRequiredInput1
Canonical station identifier, typically the identifier returned by maintenance-charge-points-summary (round-trip it unchanged). Also accepts evseId, connector evseId, serialNumber or OCPP identity. Exact match only.
Output33
Canonical station identifier; round-trip unchanged to other charge-points-* tools.
Normalized EVSE id when assigned; null during setup.
Stored EVSE id as shown to humans; may contain separators.
Serial number of the station; falls back to the one reported at boot, as the dashboard does.
Charge point manufacturer
Charge point model
activeIssuesobject[]REQUIRED
Issue type identifier
low: informational. medium: may need attention. high: likely impacting operation. critical: station unable to function.
connectorsobject[]REQUIRED
Maximum power in kW
available: ready for a new session. preparing: vehicle plugged in, not yet charging. ev-connected: vehicle connected but charging not started. charging: actively delivering energy. occupied: connector in use but not charging. suspended-evse: charging paused by the station. suspended-ev: charging paused by the vehicle. idle: connected but no energy flow. finishing: session ending, wrapping up. unavailable: connector not available for use (e.g. maintenance). faulted: error state, may need physical intervention. reserved: reserved for a specific user. unknown: status could not be determined.
Serial number reported in the boot notification.
Charge box serial number reported in the boot notification.
Firmware version reported in the boot notification.
IMSI of the SIM card in the station, from the boot notification. The first thing to check when a station is offline.
ICCID of the SIM card in the station, from the boot notification.
Type of the energy meter, from the boot notification.
Serial number of the energy meter, from the boot notification.
operationalStatusobject | nullREQUIREDOperational status as set on the station (e.g. Live), with the canonical status it maps to.
Operational status as set on the station (e.g. Live), with the canonical status it maps to.
providerobject | nullREQUIREDThe provider the station belongs to. Name only.
The provider the station belongs to. Name only.
accountobject | nullREQUIREDThe customer account that owns the station. Name only.
The customer account that owns the station. Name only.
locationobject | nullREQUIREDThe location of the station. Name only, no address.
The location of the station. Name only, no address.
maintenanceAccountobject | nullREQUIREDThe installer account that maintains the station. Name only.
The installer account that maintains the station. Name only.
billingPlanobject | nullREQUIREDThe subscription (billing plan) on the station. Name only.
The subscription (billing plan) on the station. Name only.
accessGroupsobject[]REQUIREDAccess groups on the station. Names only.
Access groups on the station. Names only.
For installers (Field Service Technicians): the charge stations their installer account maintains, which belong to customers and are therefore not in charge-points-summary. Returns counts by connectivity and operational status, open detected issues, and a list (up to 50) with the same station fields as charge-points-summary (open issue count included), plus the customer account and location name. Archived stations are excluded. No sessions, tariffs, roaming settings or firmware, and only the count of issues; call maintenance-charge-points-details with a station identifier for the issues themselves and the full station overview. Requires maintenance access on the caller's account; otherwise `access` says why and the result is empty. Use charge-points-summary for stations the caller owns as a customer, and charge-points-status for the live state of one station. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.
Verified customerRequiredInput
Output4
granted: the caller may see the stations their installer account maintains. no-account: the verified user has no account. no-permission: the verified user has no maintenance access; stats and the list are then empty.
Why access was not granted; null when it was.
statsobject | nullREQUIRED
Stations the installer account maintains, archived ones excluded.
Unresolved detected issues across all maintained stations.
Station count per connectivity state.
Station count per operational status name; "none" for stations without one.
True when the list holds fewer stations than chargePoints.
chargePointsobject[]REQUIRED
Canonical station identifier; round-trip unchanged to other charge-points-* tools.
Normalized EVSE id when assigned; null during setup.
Stored EVSE id as shown to humans; may contain separators.
Charge point manufacturer
Charge point model
ISO timestamp the charge point was last seen.
Count of active (unresolved) issues on this charge point.
accountobject | nullREQUIREDThe customer account that owns the station. Name only.
The customer account that owns the station. Name only.
locationobject | nullREQUIREDThe location of the station. Name only.
The location of the station. Name only.
connectorsobject[]REQUIRED
Maximum power in kW
available: ready for a new session. preparing: vehicle plugged in, not yet charging. ev-connected: vehicle connected but charging not started. charging: actively delivering energy. occupied: connector in use but not charging. suspended-evse: charging paused by the station. suspended-ev: charging paused by the vehicle. idle: connected but no energy flow. finishing: session ending, wrapping up. unavailable: connector not available for use (e.g. maintenance). faulted: error state, may need physical intervention. reserved: reserved for a specific user. unknown: status could not be determined.