Create a new booking
POST/bookings
Create a new charging reservation at a specific location and EVSE.
The booking is initially created in REQUESTED status and transitions to
PENDING while awaiting confirmation from the CPO. Once confirmed, the
status changes to CONFIRMED.
Pricing: The client_price in the response includes:
- Base CPO cost
- Your configured reservation fee
- Your configured commission percentage
Time Windows:
- Reservations must be at least 15 minutes in the future
- Maximum reservation duration is typically 4 hours (CPO-dependent)
- Expiry is automatic if not attended within the reserved time window
Request
Responses
- 202
- 400
- 401
- 404
- 409
- 429
Booking request accepted and being processed
Bad request - invalid input parameters
Unauthorized - missing or invalid API key
Location or EVSE not found
Conflict - EVSE not available for requested time
Rate limit exceeded
Response Headers
Retry-After
Seconds to wait before retrying
X-RateLimit-Limit
Request limit per minute
X-RateLimit-Remaining
Remaining requests in current window
X-RateLimit-Reset
ISO 8601 timestamp when limit resets