The Reservation object

{
    "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

string

required

Unique identifier for the object.

string | null

ID of the assigned charging station, once the reservation is confirmed.

string

ID of the driver associated with the reservation.

string

required

Ideal reservation end time (requested by driver). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

required

Ideal reservation start time (requested by driver). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

required

Current status of the reservation.Available options: pending, confirmed, completed, cancelled, failed, expired

string

ID of the vehicle associated with the reservation.

More attributes

string

required

String representing the object’s type.Available options: reservation

object

Cancellation rules for the reservation.

Show properties

integer

Time in seconds before reservation start when cancellation is free.

string

required

Type of cancellation policy applied to this reservation.Available options: free_cancellation, non_refundable

string | null

Time when reservation status changed to confirmed. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

array of string

Acceptable connector types for charging.

string

required

Time at which the reservation was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

ISO 4217 currency code for the reservation fee.

string | null

Earliest acceptable reservation start time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string | null

Reason why reservation failed, if applicable.Available options: no_available_connectors, payment_failed, other

string | null

Latest acceptable reservation end time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

object

Geographic area where Charge should search for a station.

Show properties

number

required

Latitude of the search area center point.

number

required

Longitude of the search area center point.

integer

required

Radius around the location in meters.

object

Set of key-value pairs that you can attach to an object.

string

ID of the payment method used for the reservation fee.

integer

Reservation fee amount in the smallest currency unit.

string | null

Finalized end time after confirmation. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string | null

Finalized start time after confirmation. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

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.

Getting Started

API Behavior

API Reference

The Reservation object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes