POST
/
reservations
/
{reservation}
/
confirm
curl --request POST \
  --url https://api.chargeapi.co/v1/reservations/{reservation}/confirm \
  --header 'Content-Type: application/json' \
  --data '{
  "payment_method": "pm_12345"
}'
{
  "id": "<string>",
  "object": "reservation",
  "cancellation_policy": {
    "free_until_before": 123,
    "type": "free_cancellation"
  },
  "charging_station": "<string>",
  "confirmed_at": 123,
  "connector_type": [
    "<string>"
  ],
  "created": 123,
  "currency": "<string>",
  "driver": "<string>",
  "earliest_start": 123,
  "failed_reason": "no_available_connectors",
  "ideal_end": 123,
  "ideal_start": 123,
  "latest_end": 123,
  "location": {
    "latitude": 123,
    "longitude": 123,
    "radius": 123
  },
  "metadata": {},
  "payment_method": "<string>",
  "reservation_fee": 123,
  "reserved_end": 123,
  "reserved_start": 123,
  "status": "pending",
  "updated": 123,
  "vehicle": "<string>"
}

Path Parameters

​
reservation
string
required

ID of the reservation intent to confirm.

Body

application/json

Response

200
application/json

Returns the Reservation object with the reservation’s final status. If successful, status is updated to confirmed, and a compatible charging station is assigned. If no station is available, the status becomes failed, with a failed_reason provided.

The Reservation object represents a driver's intent to charge their vehicle within a specific time window (ideal_start/ideal_end) and geographic area (location). Initially, a reservation is in a pending state. Charge automatically attempts to assign an available charging station and confirm the reservation approximately 30 minutes before the desired start time. If successful, the reservation status updates to confirmed, locking a connector at the assigned charging station. If no suitable charging station is available, the reservation status changes to failed with a failed_reason. Once charging successfully occurs, the reservation status becomes completed. Reservations can also be cancelled by the driver or automatically expired if unused.