Maturity status | Alpha |
This article explains what User-based Prioritization is, how it allocates charging power based on driver priority, and how to activate and configure it via the gridX API.
What is User-based Prioritization?
User-based Prioritization allocates EV charging power based on the priority level of the connected EV driver. Higher-priority drivers receive preferential access to charging power when site capacity is limited.
Priority levels are defined by a third-party system and can represent membership tiers (for example, Basic, Standard, Premium) or organizational roles (for example, executives, employees, guests). The gridX EMS receives priority values from the third-party system via the gridX API and applies them to charging power distribution.
How does User-based Prioritization work?
The EMS uses driver priority values to determine how charging power is distributed across EV charging stations (EVCS). Higher priority values result in higher charging power allocation. The logic for how priority influences power distribution is the same as described in EVCS-Specific Configuration for priority charging.
Key behavior:
Prioritization takes effect when EVs are limited due to grid or cluster limits, vehicles with a higher priority are charged first.
When active, user-based prioritization overrides the static priority of the EVCS-Specific Configuration — if the gridBox loses connectivity to the API for more than one hour, it falls back to that static prioritization
Setting at least one priority value via the API activates the feature — there is no toggle in the XENON Dashboard
What are the requirements for User-based Prioritization?
The Energy Management System (EMS) must be active on the site
A third-party system that provides driver priority data via the gridX API
User-based Prioritization is currently in Alpha and requires a special deployment — contact gridX to enable it for your deployment
How do I configure User-based Prioritization?
Configuration is API-only — there is no XENON Dashboard toggle. Setting at least one priority value via the API activates the feature.
Step 1: Find the asset ID
Use the Asset Lookup endpoint to retrieve the XENON asset ID for a charging station by serial number:
`POST /emobility/assets { "asset": { "serialNumber": "100132057", "connectorNumber": 2 } }``` The serial number must be at least five characters. Include "connectorNumber" only if the charging station has multiple connectors (for example, two-connector DC chargers). **Step 2: Set the driver priority** Use the asset ID from Step 1 to assign a priority value to the charging station: `PUT /systems/{systemID}/evcs-user-priorities/{assetID}{
{
"priority": 100
}```
Higher values indicate higher priority. The default value is 0. Assets with priority 0 are treated as unprioritized.
What are the limitations of User-based Prioritization?
Alpha feature — requires a special deployment to enabled in the gridBox deployment by gridX
Configuration is API-only — priority values are not visible or manageable in the XENON Dashboard