Skip to main content
{
    "id": "res_nfJiRR1ok35nSfnIpS4tC7SAsUk0K3As",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": "chst_AwAMEuLnH0Umz3DhtEjEaHACtMcscDDY",
    "confirmed_at": "2026-04-01T01:04:32.666Z",
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:36:20.907Z",
    "currency": "eur",
    "driver": "drv_OAVzBPkaauGK3svjp2YxHyGkZxPjIuSB",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T03:06:35.302Z",
    "ideal_start": "2026-04-01T01:36:39.198Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {},
    "payment_method": "pm_ifwG4OMNnEmqjpi7cP8EJvxiRZAzGOEX",
    "reservation_fee": 1200,
    "reserved_end": "2026-04-01T03:06:19.700Z",
    "reserved_start": "2026-04-01T01:36:39.901Z",
    "status": "confirmed",
    "updated": "2026-04-01T01:10:19.775Z",
    "vehicle": "veh_O3C7oq0HKOkNlpzokFN5eTTVWImdeLKy"
}

{
    "id": "res_nfJiRR1ok35nSfnIpS4tC7SAsUk0K3As",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": "chst_AwAMEuLnH0Umz3DhtEjEaHACtMcscDDY",
    "confirmed_at": "2026-04-01T01:04:32.666Z",
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:36:20.907Z",
    "currency": "eur",
    "driver": "drv_OAVzBPkaauGK3svjp2YxHyGkZxPjIuSB",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T03:06:35.302Z",
    "ideal_start": "2026-04-01T01:36:39.198Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {},
    "payment_method": "pm_ifwG4OMNnEmqjpi7cP8EJvxiRZAzGOEX",
    "reservation_fee": 1200,
    "reserved_end": "2026-04-01T03:06:19.700Z",
    "reserved_start": "2026-04-01T01:36:39.901Z",
    "status": "confirmed",
    "updated": "2026-04-01T01:10:19.775Z",
    "vehicle": "veh_O3C7oq0HKOkNlpzokFN5eTTVWImdeLKy"
}
This object represents a reservation in Charge. It captures a request to reserve charging capacity for a driver and vehicle within a requested time window. Reservations begin in pending and move through confirmation, completion, cancellation, failure, or expiration as Charge processes them.

​
Attributes

​
id
string
required
Unique identifier for the object.
​
charging_station
string | null
ID of the assigned charging station, once the reservation is confirmed.
​
driver
string
ID of the driver associated with the reservation.
​
ideal_end
string
required
Ideal reservation end time (requested by driver). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
ideal_start
string
required
Ideal reservation start time (requested by driver). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
status
string
required
Current status of the reservation.Available options: pending, confirmed, completed, cancelled, failed, expired
​
vehicle
string
ID of the vehicle associated with the reservation.

​
More attributes

​
object
string
required
String representing the object’s type.Available options: reservation
​
cancellation_policy
object
Cancellation rules for the reservation.
​
confirmed_at
string | null
Time when reservation status changed to confirmed. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
connector_type
array of string
Acceptable connector types for charging.
​
created
string
required
Time at which the reservation was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
currency
string
ISO 4217 currency code for the reservation fee.
​
earliest_start
string | null
Earliest acceptable reservation start time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
failed_reason
string | null
Reason why reservation failed, if applicable.Available options: no_available_connectors, payment_failed, other
​
latest_end
string | null
Latest acceptable reservation end time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
location
object
Geographic area where Charge should search for a station.
​
metadata
object
Set of key-value pairs that you can attach to an object.
​
payment_method
string
ID of the payment method used for the reservation fee.
​
reservation_fee
integer
Reservation fee amount in the smallest currency unit.
​
reserved_end
string | null
Finalized end time after confirmation. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
reserved_start
string | null
Finalized start time after confirmation. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
updated
string
required
Time at which the reservation was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.