ReserveNow

Reserves a connector for a specific token until an expiry time.

Version: OCPP 1.6
Direction: CSMS → Charge Point
Feature profile: Reservation

ReserveNow also exists in OCPP 2.0.1, with a different payload. See the OCPP 2.0.1 version.

ReserveNow holds a connector for one user. Until the reservation expires or is cancelled, only the reserved token — or its parent token — may start a session there.

The connector moves to status Reserved, and the reservation ends when the session starts, when it expires, or when CancelReservation arrives.

Request

Field	Type	Required	Description
`connectorId`	integer	Required	Connector to reserve. 0 means any connector on the charge point.
`expiryDate`	dateTime	Required	When the reservation lapses.
`idTag`	IdToken	Required	The token the reservation is held for.
`reservationId`	integer	Required	Identifier for this reservation, chosen by the CSMS.
`parentIdTag`	IdToken	Optional	Parent token that may also use the reservation.

json

[2, "19223201", "ReserveNow", {
  "connectorId": 1,
  "expiryDate": "2026-09-09T11:30:00.000Z",
  "idTag": "04A1B2C3D4E580",
  "reservationId": 77
}]

Response

Field	Type	Required	Description
`status`	ReservationStatus	Required	Whether the reservation was made.

json

[3, "19223201", {
  "status": "Accepted"
}]

Values

ReservationStatus

Value	Meaning
`Accepted`	The reservation was made.
`Faulted`	The connector is faulted and cannot be reserved.
`Occupied`	The connector is in use.
`Rejected`	The charge point does not support reservations, or refused.
`Unavailable`	The connector is set Inoperative.

Implementation notes

Reusing a `reservationId` replaces the existing reservation rather than creating a second one. The CSMS owns the id space and is responsible for keeping ids unique.

connectorId: 0 reserves any connector, which means the charge point picks when the driver arrives. Not every model supports this.

An expired reservation should return the connector to Available with a StatusNotification. Chargers that leave it Reserved forever strand the socket.