Access groups
The access groups on the caller's account: who may charge on the account's private charge points and at what price. Returns groups shared with the whole account plus the caller's own private groups; another user's private groups are never returned. Per group: name, type (cards or users), authorization mode, visibility (Shared or Private), the number of charge points it is attached to, and its members (up to 100, with the full count) with card number, hashed RFID uid, name, price type, price per kWh with its currency, and whether they are billed. Use it for "who has access to my chargers"; for "why can this card charge here" pass the card number or RFID uid as card, which returns only the groups holding that card. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.
Verified customerRequiredInput1
Printed card number or RFID uid of one card. Only the groups that hold it are returned, with just that member.
Output3
accessGroupsobject[]REQUIRED
rfid: members are cards; users: members are platform users.
Whether the group grants unrestricted or restricted access on the charge points it is attached to.
Access Group Visibility, as in the dashboard. Shared: visible to all users in this account; Private: visible only to the caller, who owns it.
membersobject[]REQUIRED
How the member is identified.
Label given to the member; for a user member, the user name. Null if never set.
Hash of the RFID uid of an rfid member; the raw uid is secret and never returned. The same hash as the uid hash on a session attempt or a card finding elsewhere, so it tells whether a refused card is this member.
Card number printed on the card, for a visualNumber member.
True when the saved code looks like the other entry type: a printed card number saved as an RFID uid, or an RFID uid saved as a printed card number. The card is then not recognised; the fix is to remove it and add the same code again under the other type. False when the code matches its type. Null for a user member, or when the code cannot be judged.
free: charges at no cost and is always accepted; custom: pricePerKwh applies; default (rare, only on restricted groups with extended access groups enabled): the tariff of the charge point applies.
Price per kWh when priceType is custom.
Currency of pricePerKwh: the billing currency of the account. Null without a price.
True when sessions of this member are not billed.
True when members lists only the first part of a larger group.
Number of charge points the group is attached to, at station or connector level.
Why the list is empty, when it is.
The charge points the caller can see (same scope as charge-points-summary, up to 50), each with the access groups attached to it: name, type, visibility (Shared or Private), authorization mode, member count, and the connectors it applies to (null means the whole charge point). Use it for "which access groups are on this charger" and "why can someone charge here". Member counts only; call access-groups-account for who is in each group. A colleague's Private group is never returned, only counted in hiddenGroupCount. Pass identifier to ask about one charge point. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.
Verified customerRequiredInput1
One charge point: its identifier as returned by charge-points-find or charge-points-summary, or its evseId, connector evseId, serial number or OCPP identity. Exact match only.
Output5
account: every charge point on the account except the home chargers of colleagues; own: only charge points linked to the caller. Same scope as charge-points-summary.
True when chargePoints lists only the first part.
chargePointsobject[]REQUIRED
Round-trips to charge-points-details and charge-points-status.
locationobject | nullREQUIRED
accessGroupsobject[]REQUIRED
rfid: members are cards; users: members are platform users.
Access Group Visibility, as in the dashboard. Private groups are only shown to their owner.
Connectors the group is attached to; null when it applies to the whole charge point.
Private groups of other users on this account attached to this charge point: they can grant access here, but their names and members are not shown.
Why the list is empty, when it is.