Charging stations

charge-points-detailsREAD-ONLY

Get detailed private information about a charge station, scoped to the caller. Returns account, billing plan, location including who is reimbursed for sessions and who is invoiced for the subscription, whether it is published publicly, the installer or maintenance account, connector specifications, active issues, and the per-connector OCPI tariff as pushed to roaming partners. Scoped to the caller: a station at a location linked to them, or any station on the account for a caller with account-level charge-point read access, except a colleague's employee-reimburse (home) charge point, which is never shown. Anything out of scope is reported as not found, the same as a station that does not exist. The `identifier` must be precise (typically the `normalizedEvseId` returned by charge-points-find). If the user gave a description, partial id, or noisy voice input, call charge-points-find first to resolve it. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.

Customer
Verified customer
Conversation token
Required
Schema
Input1
identifierstringREQUIRED
Output25
identifierstringREQUIRED
normalizedEvseIdstring | nullREQUIRED
namestring | nullREQUIRED
evseIdstring | nullREQUIRED
serialNumberstring | nullREQUIRED
vendorstring | nullREQUIRED
modelstring | nullREQUIRED
ocppIdentitystring | nullREQUIRED
ocppProtocolVersionstring | nullREQUIRED
connectivityStateenum | nullREQUIRED
numConnectorsnumber | nullREQUIRED
lastBootedAtstring | nullREQUIRED
setupFinishedboolean | nullREQUIRED
enablePublicChargingboolean | nullREQUIRED
enablePublicFreeChargingboolean | nullREQUIRED
activeIssuesobject[]REQUIRED
typestringREQUIRED
severityenumREQUIRED
descriptionstringREQUIRED
lastDetectedAtstring | nullREQUIRED
connectorsobject[]REQUIRED
connectorIdnumberREQUIRED
evseIdstring | nullREQUIRED
standardstring | nullREQUIRED
formatstring | nullREQUIRED
powerTypestring | nullREQUIRED
maxPowernumber | nullREQUIRED
maxVoltagenumber | nullREQUIRED
maxAmperagenumber | nullREQUIRED
statusenumREQUIRED
tariffobject | nullREQUIRED
idstringREQUIRED
currencystringREQUIRED
tariff_alt_textobject[] | nullREQUIRED
languagestringREQUIRED
textstringREQUIRED
elementsobject[]REQUIRED
price_componentsobject[]REQUIRED
typeenumREQUIRED
pricenumberREQUIRED
step_sizenumber | nullREQUIRED
restrictionsobject | nullREQUIRED
start_timestring | nullREQUIRED
end_timestring | nullREQUIRED
start_datestring | nullREQUIRED
end_datestring | nullREQUIRED
day_of_weekenum[] | nullREQUIRED
min_durationnumber | nullREQUIRED
max_durationnumber | nullREQUIRED
min_kwhnumber | nullREQUIRED
max_kwhnumber | nullREQUIRED
min_powernumber | nullREQUIRED
max_powernumber | nullREQUIRED
last_updatedstring | nullREQUIRED
firmwareVersionstring | nullREQUIRED
isDisabledboolean | nullREQUIRED
activatedAtstring | nullREQUIRED
createdAtstringREQUIRED
accountobject | nullREQUIRED
idstringREQUIRED
namestringREQUIRED
maintenanceAccountobject | nullREQUIRED
idstringREQUIRED
namestringREQUIRED
billingPlanobject | nullREQUIRED
idstringREQUIRED
namestringREQUIRED
locationobject | nullREQUIRED
addressstring | nullREQUIRED
citystring | nullREQUIRED
postalCodestring | nullREQUIRED
countrystring | nullREQUIRED
timezonestring | nullREQUIRED
publishingModestring | nullREQUIRED
billingPolicyobject | nullREQUIRED
summarystringREQUIRED
usageReimbursementobject[]REQUIRED
entityTypestring | nullREQUIRED
namestring | nullREQUIRED
methodstring | nullREQUIRED
percentagenumber | nullREQUIRED
fixedPartnumber | nullREQUIRED
allocationTypestring | nullREQUIRED
subscriptionBillingobject[]REQUIRED
entityTypestring | nullREQUIRED
namestring | nullREQUIRED
methodstring | nullREQUIRED
percentagenumber | nullREQUIRED
charge-points-diagnoseREAD-ONLY

Works out what went wrong at a charging station from its OCPP message log and returns findings, not the log: cards refused or blocked by their provider, a card held by a session open elsewhere (with its externalSessionId), starts from the app, Scan to Pay or a payment terminal that the charging station rejected or never followed, no attempt reaching us at all, sessions that never charged or died at once, power held back, a car not taking power, faults with their error codes, restarts, connection drops and late messages. Each finding has a severity, a count, the few facts behind it, and a recommended `nextStep` (action, reason, then) for the audience: the owner when the verified caller is on its account and can see it, else the installer when the verified caller is on the installer account that maintains it, otherwise a driver. Station-side actions (power_cycle, check_station_settings, add_to_access_group, inspect_on_site) are never given to a driver, and a driver only gets stop_session for a stuck session on a card of their own account. `afterReboot` is true when the problem came back after a restart, and the next step then moves on. Give `from` / `to` when the driver says when they tried; otherwise the last 12 hours are read. `connectorId` narrows to one connector (station-wide messages are kept). `checked` lists every rule evaluated, so an empty `findings` is a real answer, unless `logAvailable` is false: then the station has no OCPP log to read and nothing could be checked.

Customer
No verification needed
Conversation token
Optional
Schema
Input4
identifierstringREQUIRED
connectorIdinteger
fromstring
tostring
Output8
audienceenumREQUIRED
logAvailablebooleanREQUIRED
windowobjectREQUIRED
fromstringREQUIRED
tostringREQUIRED
explicitbooleanREQUIRED
messagesReadintegerREQUIRED
truncatedbooleanREQUIRED
findingsobject[]REQUIRED
codeenumREQUIRED
severityenumREQUIRED
connectorIdnumber | nullREQUIRED
firstAtstringREQUIRED
lastAtstringREQUIRED
countintegerREQUIRED
summarystringREQUIRED
evidenceobjectREQUIRED
afterRebootbooleanREQUIRED
nextStepobjectREQUIRED
actionenumREQUIRED
reasonstringREQUIRED
thenenum | nullREQUIRED
connectorsobject[]REQUIRED
connectorIdnumberREQUIRED
lastSessionobject | nullREQUIRED
startedAtstring | nullREQUIRED
endedAtstring | nullREQUIRED
reachedChargingbooleanREQUIRED
stopReasonstring | nullREQUIRED
energyKWhnumber | nullREQUIRED
checkedenum[]REQUIRED
charge-points-findREAD-ONLY

Disambiguate a charge station from fuzzy, partial, or voice-shaped input. Accepts free text (address, city, vendor, station name) or a noisy id (e.g. "NL*EFL*EV2985978*C1" or "AC 10729 126"). Pass a spelled id as its letters and digits ("EXEFNAV88V"), not as spelling-alphabet words. Returns candidate stations with their canonical `normalizedEvseId`, best match first. Each result has a `matchType`: confirm an `exact` match directly; read a `phonetic` match back to the customer with a spelling alphabet before acting on it; for `partial` matches let the customer pick. The caller must pass the `normalizedEvseId` back into charge-points-status / -details / -reboot / -unlock to act on a station; those tools do not accept fuzzy input. No authentication required.

Customer
No verification needed
Conversation token
Optional
Schema
Input1
querystringREQUIRED
Output2
resultsobject[]REQUIRED
identifierstringREQUIRED
normalizedEvseIdstring | nullREQUIRED
namestring | nullREQUIRED
evseIdstring | nullREQUIRED
serialNumberstring | nullREQUIRED
vendorstring | nullREQUIRED
modelstring | nullREQUIRED
connectivityStateenum | nullREQUIRED
numConnectorsnumber | nullREQUIRED
addressstring | nullREQUIRED
citystring | nullREQUIRED
countrystring | nullREQUIRED
matchTypeenumREQUIRED
connectorsobject[]REQUIRED
connectorIdnumber | nullREQUIRED
evseIdstring | nullREQUIRED
totalnumberREQUIRED
charge-points-rebootSTATE-CHANGING

Reboot a charge station with a built-in safety check. Before sending the reset the tool verifies, server-side, that the station is online, that no other driver is charging on it (on multi-connector stations), and that the customer's most recent attempt to start a session was not rejected for token-level reasons. It reboots the station only when those checks pass. The response is shaped as: `reset` (boolean, whether the reset actually ran), `reason` (the human-readable explanation to relay to the customer), and two independent agent hints: `needConnector` (ask the customer which connector they are using, left is 1, right is 2, and call again with connectorId) and `escalate` (the reset will not help, hand off to human support). Also returns `lastSessionAttempt` mirroring the charge-points-status tool, so the agent has context for whatever it tells the customer. Does not require authentication, but a verified session lets the tool tell the customer's own token failures apart from someone else's. The `identifier` must be precise (typically the `normalizedEvseId` returned by charge-points-find); if the user gave a description, partial id, or noisy voice input, call charge-points-find first to resolve it.

Customer
No verification needed
Conversation token
Optional
Schema
Input2
identifierstringREQUIRED
connectorIdinteger
Output8
resetbooleanREQUIRED
reasonstringREQUIRED
needConnectorbooleanREQUIRED
escalatebooleanREQUIRED
connectivityStatestringREQUIRED
connectorCountnumberREQUIRED
connectorsobject[]REQUIRED
idnumberREQUIRED
statusstringREQUIRED
lastSessionAttemptobject | nullREQUIRED
outcomeenumREQUIRED
atstringREQUIRED
authorizationobjectREQUIRED
customerOwnedboolean | nullREQUIRED
uidHashstring | nullREQUIRED
charge-points-sessionsREAD-ONLY

Lists charging sessions that took place on the account's charge points (the operator view): who charged, energy delivered, duration and revenue. Returns live (in-progress) and recent (completed) sessions. Callers with account-level charge-point session read access see sessions on all the account's charge points, except a colleague's employee-reimburse (home) charge point; other callers see only sessions at locations linked to them (e.g. their own home charge point). For sessions the account's users ran at other operators, use charging-cards-sessions. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.

Customer
Verified customer
Conversation token
Required
Schema
Input
No parameters.
Output3
accountIdstring | nullREQUIRED
liveobject[]REQUIRED
statusstringREQUIRED
chargePointobjectREQUIRED
identifierstring | nullREQUIRED
namestring | nullREQUIRED
driverobject | nullREQUIRED
visualstring | nullREQUIRED
uidHashstring | nullREQUIRED
startedAtstring | nullREQUIRED
endedAtstring | nullREQUIRED
kwhnumber | nullREQUIRED
durationSecondsnumber | nullREQUIRED
revenueobjectREQUIRED
amountnumber | nullREQUIRED
currencystring | nullREQUIRED
locationobject | nullREQUIRED
namestring | nullREQUIRED
addressstring | nullREQUIRED
recentobject[]REQUIRED
statusstringREQUIRED
chargePointobjectREQUIRED
identifierstring | nullREQUIRED
namestring | nullREQUIRED
driverobject | nullREQUIRED
visualstring | nullREQUIRED
uidHashstring | nullREQUIRED
startedAtstring | nullREQUIRED
endedAtstring | nullREQUIRED
kwhnumber | nullREQUIRED
durationSecondsnumber | nullREQUIRED
revenueobjectREQUIRED
amountnumber | nullREQUIRED
currencystring | nullREQUIRED
locationobject | nullREQUIRED
namestring | nullREQUIRED
addressstring | nullREQUIRED
charge-points-statusREAD-ONLY

Gather the facts needed to reason about a charge station: connectivity, per-connector status, active issues, tariff, last successful session per connector, and the most recent token-authorisation attempt. The per-connector tariff is formatted according to the OCPI standard.Use this to answer questions about whether a station is online, available, or experiencing problems, and to understand why a customer cannot charge. Returns non-sensitive information; no authentication required. When a verified caller is attached, the most-recent-attempt section is enriched to indicate whether the attempt was made with one of the caller's own tokens. When the most recent attempt was refused because the token already had a session running elsewhere (outcome `ConcurrentTx`), `blockingSessionId` names that session, so the customer can be told what is holding their card and a human picking the case up does not have to search for it. Calling this is NEVER required before charge-points-reboot: the reboot tool runs the same checks internally as a safety gate. The `identifier` must be precise (typically the `normalizedEvseId` returned by charge-points-find); if the user gave a description, partial id, or noisy voice input, call charge-points-find first to resolve it.

Customer
No verification needed
Conversation token
Optional
Schema
Input1
identifierstringREQUIRED
Output24
identifierstringREQUIRED
normalizedEvseIdstring | nullREQUIRED
namestring | nullREQUIRED
evseIdstring | nullREQUIRED
serialNumberstring | nullREQUIRED
vendorstring | nullREQUIRED
modelstring | nullREQUIRED
ocppIdentitystring | nullREQUIRED
ocppProtocolVersionstring | nullREQUIRED
connectivityStateenum | nullREQUIRED
numConnectorsnumber | nullREQUIRED
lastBootedAtstring | nullREQUIRED
setupFinishedboolean | nullREQUIRED
enablePublicChargingboolean | nullREQUIRED
enablePublicFreeChargingboolean | nullREQUIRED
activeIssuesobject[]REQUIRED
typestringREQUIRED
severityenumREQUIRED
descriptionstringREQUIRED
lastDetectedAtstring | nullREQUIRED
connectorsobject[]REQUIRED
connectorIdnumberREQUIRED
evseIdstring | nullREQUIRED
standardstring | nullREQUIRED
formatstring | nullREQUIRED
powerTypestring | nullREQUIRED
maxPowernumber | nullREQUIRED
maxVoltagenumber | nullREQUIRED
maxAmperagenumber | nullREQUIRED
statusenumREQUIRED
tariffobject | nullREQUIRED
idstringREQUIRED
currencystringREQUIRED
tariff_alt_textobject[] | nullREQUIRED
languagestringREQUIRED
textstringREQUIRED
elementsobject[]REQUIRED
price_componentsobject[]REQUIRED
typeenumREQUIRED
pricenumberREQUIRED
step_sizenumber | nullREQUIRED
restrictionsobject | nullREQUIRED
start_timestring | nullREQUIRED
end_timestring | nullREQUIRED
start_datestring | nullREQUIRED
end_datestring | nullREQUIRED
day_of_weekenum[] | nullREQUIRED
min_durationnumber | nullREQUIRED
max_durationnumber | nullREQUIRED
min_kwhnumber | nullREQUIRED
max_kwhnumber | nullREQUIRED
min_powernumber | nullREQUIRED
max_powernumber | nullREQUIRED
last_updatedstring | nullREQUIRED
lastCompletedSessionAtstring | nullREQUIRED
connectivityStateUpdatedAtstring | nullREQUIRED
heartbeatReceivedAtstring | nullREQUIRED
lastActivityAtstring | nullREQUIRED
operationalStatusobject | nullREQUIRED
namestringREQUIRED
canonicalStatusenum | nullREQUIRED
chargingStationStatusenum | nullREQUIRED
rebootRequiredbooleanREQUIRED
lastSessionAttemptobject | nullREQUIRED
outcomeenumREQUIRED
atstringREQUIRED
authorizationobjectREQUIRED
customerOwnedboolean | nullREQUIRED
uidHashstring | nullREQUIRED
blockingSessionIdstring | nullREQUIRED
charge-points-summaryREAD-ONLY

Returns an account-wide charge-point summary: how many charge points and locations the account operates, sessions currently active on them, and current-month CPO session totals (energy, duration), plus a list of the account's charge points (up to 50). Callers with account-level charge-point read access see the list; other callers see the aggregate stats only. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.

Customer
Verified customer
Conversation token
Required
Schema
Input
No parameters.
Output3
accountIdstring | nullREQUIRED
statsobject | nullREQUIRED
visibilityenumREQUIRED
truncatedbooleanREQUIRED
locationsnumberREQUIRED
chargePointsnumberREQUIRED
onlinenumberREQUIRED
offlinenumberREQUIRED
needsAttentionnumberREQUIRED
roamingEnablednumberREQUIRED
openIssuesnumberREQUIRED
connectorsobjectREQUIRED
activeSessionsnumberREQUIRED
sessionsobjectREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
revenueobject[]REQUIRED
currencystring | nullREQUIRED
amountnumberREQUIRED
chargePointsobject[]REQUIRED
identifierstringREQUIRED
normalizedEvseIdstring | nullREQUIRED
namestring | nullREQUIRED
evseIdstring | nullREQUIRED
vendorstring | nullREQUIRED
modelstring | nullREQUIRED
connectivityStateenum | nullREQUIRED
numConnectorsnumber | nullREQUIRED
enablePublicChargingboolean | nullREQUIRED
lastActivityAtstring | nullREQUIRED
isDisabledboolean | nullREQUIRED
rebootRequiredbooleanREQUIRED
locationobject | nullREQUIRED
addressstring | nullREQUIRED
citystring | nullREQUIRED
openIssuesnumberREQUIRED
connectorsobject[]REQUIRED
connectorIdnumberREQUIRED
evseIdstring | nullREQUIRED
standardstring | nullREQUIRED
formatstring | nullREQUIRED
powerTypestring | nullREQUIRED
maxPowernumber | nullREQUIRED
statusenumREQUIRED
hasTariffbooleanREQUIRED
charge-points-unlockSTATE-CHANGING

Unlock a connector on a charge station to release a stuck cable. Use when a customer reports they cannot unplug their vehicle. Does not require authentication; intended as a self-service action for the person standing at the station. The `identifier` must be precise (typically the `normalizedEvseId` returned by charge-points-find). If the user gave a description, partial id, or noisy voice input, call charge-points-find first to resolve it.

Customer
No verification needed
Conversation token
Optional
Schema
Input2
identifierstringREQUIRED
connectorIdstringREQUIRED
Output
No output.