Skip to main content

Fleet Group Tokens

The group_token strategy uses a shared token that represents the entire fleet group. Any driver in the group can use it — ideal when vehicles rotate between drivers.

How Group Tokens Work​

  1. A fleet group is created in the EV Suite dashboard with a spending limit
  2. Bulk tokens are generated for the group (via POST /groups/{id}/tokens/bulk)
  3. When you book with group_token, the reservation is tied to the group — not a specific driver
  4. Any driver in the group can present the token at the charger
  5. Usage is tracked against the group's spending limit

Create a Booking with group_token​

curl -s -X POST https://api.petitmonde.energy/api/v1/client/bookings \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "DE-ION-E789012",
    "evse_uid": "DE*ION*E789012*2",
    "reservation_start": "2026-02-10T08:00:00Z",
    "reservation_end": "2026-02-10T10:00:00Z",
    "external_id": "fleet-group-a-morning-charge",
    "token_strategy": "group_token",
    "fleet_group_id": "group_abc123"
  }' | jq .

Required fields:

  • fleet_group_id — Identifies which fleet group's shared token to use
  • Standard booking fields (location_id, evse_uid, reservation_start, reservation_end)

Token Distribution​

Group tokens are physical RFID cards or virtual tokens issued to the fleet. Options:

  • Physical cards: Distribute cards to each vehicle's glove compartment
  • Virtual tokens: Assign via your fleet management app

Since the token is shared, losing one card doesn't require rebooking — any driver with a group token can attend the reservation.

Spending Limits​

When a group approaches its spending limit, the API returns 400:

{
  "error": "Fleet group spending limit exceeded"
}

Monitor spending by checking the group's usage through the EV Suite dashboard or the fleet management API.

When to Use group_token vs. driver_token​

ScenarioStrategy
Vehicle pool — drivers change dailygroup_token
Company cars assigned to specific employeesdriver_token
Delivery fleet with shift driversgroup_token
Executive vehicles with assigned driversdriver_token