Skip to main contentSkip to navigationSkip to search
Skip to main content
Learning Hub/Explorer
Back

Bookings

OCPI 2.2.1
Overview

Bookings let a driver reserve a charge point ahead of time so it is guaranteed free when they arrive. The driver's EMSP requests a timeslot at one of the CPO's bookable locations, and the CPO holds that charge point, moving the booking from pending to reserved and then to fulfilled once charging starts.

Who sends

EMSP (E-Mobility Service Provider)

Who receives

CPO (Charge Point Operator)

Key Fields
FieldTypeDescription

id

CiString(36)

Identifier for the booking on the CPO side

location_id

CiString(36)

Location the reservation is made on

period

Timeslot

The timeslot being booked

reservation_status

ReservationStatus

PENDING, RESERVED, FULFILLED, and so on

booking_tokens

BookingToken[]

Token(s) used to make use of the booking

Endpoints
GET

/ocpi/2.2.1/bookings/

POST

/ocpi/2.2.1/bookings/

GET

/ocpi/2.2.1/bookings/{country_code}/{party_id}/{booking_id}

PUT

/ocpi/2.2.1/bookings/{country_code}/{party_id}/{booking_id}

Live Endpoint Tester

Send requests directly to the local backend and see the response.

Skip to main content