Skip to main content

Cancel a reservation

POST 
/chargers/:id/actions/cancel-reservation

Sends an OCPP CancelReservation command to cancel an active reservation, immediately freeing the connector for other users.

Use Cases:

  • Cancel reservation when reserved user will not arrive
  • Free connector blocked by expired or stale reservation
  • Respond to user cancellation requests
  • Implement reservation timeout policies
  • Override reservations for emergency or priority access

What Happens:

  1. Reservation identified by reservation ID is cancelled
  2. Connector immediately returns to available state
  3. Other users can now start charging sessions
  4. Reserved user no longer has priority access
  5. Reservation status updated in charger and GridLink

Cancellation Behavior:

  • Immediate effect - connector available instantly
  • Does not affect active charging sessions
  • Only cancels the specified reservation (by ID)
  • Charger confirms cancellation via response
  • No undo - cancellation is permanent

Important Notes:

  • Must provide exact reservation ID from ReserveNow command
  • Cannot cancel reservations that already expired naturally
  • Wrong reservation ID returns failure status
  • Does not stop charging if reserved user already started session

Best Practices:

  • Track reservation IDs for reliable cancellation
  • Cancel promptly if reserved user will not arrive
  • Implement automatic cancellation after grace period
  • Notify reserved user when cancellation occurs
  • Monitor connector state after cancellation
info

Cancellation immediately frees the connector for all users. Use this when the reserved user will not arrive or to clear stale reservations.

warning

Ensure you have the correct reservationId. Cancelling the wrong reservation may unintentionally free a connector reserved for another user.

Request​

Responses​

Standard success response for actions