Skip to main content

Fleet: Search → Book Flow

This guide walks through the fleet-specific booking flow using group_token.

Step 1: Search near the fleet depot or destination​

curl -s "https://api.petitmonde.energy/api/v1/client/search?\
lat=48.7758&lng=9.1829&radius=15&power_min=22" \
  -H "X-API-Key: YOUR_API_KEY" | jq '.results[:3] | .[] | {location_id, name, distance_km}'

For fleet use, you'll often search near:

  • The fleet depot (morning departure charges)
  • Known delivery routes or destinations
  • Employee office locations

Step 2: Create a booking for the fleet group​

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-ALG-E456789",
    "evse_uid": "DE*ALG*E456789*1",
    "reservation_start": "2026-02-11T07:00:00Z",
    "reservation_end": "2026-02-11T09:00:00Z",
    "external_id": "fleet-delivery-route-morning",
    "token_strategy": "group_token",
    "fleet_group_id": "group_delivery_team"
  }' | jq .

Step 3: Assign to a driver​

The booking is tied to the fleet group, not a specific driver. Any driver in the group can attend. Your fleet management system decides which driver gets the assignment.

Notify the assigned driver with:

  • Charger location (name, address, coordinates)
  • Reserved time window
  • Which token to use (physical card or app)

Step 4: Monitor completion​

# Check booking status
curl -s https://api.petitmonde.energy/api/v1/client/bookings/BOOKING_ID \
  -H "X-API-Key: YOUR_API_KEY" | jq '{status, status_updated_at, client_price}'

Fleet-Specific Considerations​

Batch Bookings​

For daily fleet operations, you might create multiple bookings at once. Be mindful of rate limits — space requests at least 600ms apart if creating many bookings.

Route Planning​

Combine search results with your route planning to find chargers along delivery routes. Use start_time and end_time parameters to filter to available slots.

No-Show Handling​

If a driver doesn't show up, the booking expires automatically. You may be charged a no-show fee depending on the CPO. Monitor NO_SHOW status and address with the driver.