Skip to main content

Make a reservation on a charger

POST 
/chargers/:id/actions/reserve-now

Sends an OCPP ReserveNow command to reserve a specific connector for a designated user, blocking other users from starting sessions until reservation expires or is cancelled.

Use Cases:

  • Reserve charger for arriving fleet vehicle
  • Guarantee charging availability for priority users
  • Implement scheduled charging appointments
  • Reserve chargers for specific departments or user groups
  • Pre-book chargers via mobile app or dashboard

Reservation Behavior:

  • Connector marked as reserved for specified ID tag
  • Only the reserved user can start charging sessions
  • Other users receive "Reserved" status on authorization attempts
  • Reservation automatically expires after specified duration
  • Connector returns to available state on expiry or cancellation

Reservation Parameters:

  • Connector ID: Which connector to reserve (0 = charger chooses)
  • Expiry Date: When reservation automatically expires
  • ID Tag: User/card authorized to use reserved connector
  • Reservation ID: Unique identifier for tracking and cancellation
  • Parent ID Tag (optional): Group authorization

Expiration:

  • Reservation expires automatically at expiry date/time
  • Expired reservations free connector for general use
  • Starting a session with reserved ID tag ends reservation
  • Cancellation immediately frees connector

Best Practices:

  • Set realistic expiry times (e.g., 15-60 minutes)
  • Cancel reservations if plans change to free connector
  • Track reservation IDs for cancellation
  • Consider site policy for maximum reservation duration
  • Monitor reservation usage to prevent abuse
info

Reservations block the connector for all users EXCEPT the specified idTag. The connector remains unavailable to others until expiry, cancellation, or the reserved user starts charging.

tip

Use CancelReservation to free the connector if the reserved user will not arrive. This prevents blocking other users unnecessarily.

Request​

Responses​

Standard success response for actions