Create a Reservation

curl -X POST https://api.chargeapi.co/v1/reservations \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "connector_type": [
    "CCS"
  ],
  "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
  "ideal_end": "2026-04-01T02:45:43.318Z",
  "ideal_start": "2026-04-01T01:15:19.251Z",
  "location": {
    "latitude": 48.8698,
    "longitude": 2.3319,
    "radius": 1500
  },
  "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}'

{
    "id": "res_BzPpVflI7WIwvfvbLAU7MwYvKweypDnW",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": null,
    "confirmed_at": null,
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:15:05.782Z",
    "currency": "eur",
    "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T02:45:43.318Z",
    "ideal_start": "2026-04-01T01:15:19.251Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {},
    "payment_method": "pm_TLAK3sXzk1KvcsyGLlU8nKAN05nrF7NV",
    "reservation_fee": 1200,
    "reserved_end": null,
    "reserved_start": null,
    "status": "pending",
    "updated": "2026-04-01T00:23:12.388Z",
    "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}

curl -X POST https://api.chargeapi.co/v1/reservations \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "connector_type": [
    "CCS"
  ],
  "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
  "ideal_end": "2026-04-01T02:45:43.318Z",
  "ideal_start": "2026-04-01T01:15:19.251Z",
  "location": {
    "latitude": 48.8698,
    "longitude": 2.3319,
    "radius": 1500
  },
  "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}'

{
    "id": "res_BzPpVflI7WIwvfvbLAU7MwYvKweypDnW",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": null,
    "confirmed_at": null,
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:15:05.782Z",
    "currency": "eur",
    "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T02:45:43.318Z",
    "ideal_start": "2026-04-01T01:15:19.251Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {},
    "payment_method": "pm_TLAK3sXzk1KvcsyGLlU8nKAN05nrF7NV",
    "reservation_fee": 1200,
    "reserved_end": null,
    "reserved_start": null,
    "status": "pending",
    "updated": "2026-04-01T00:23:12.388Z",
    "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}

Creates a reservation. New reservations start in pending status. Charge attempts to confirm them about 30 minutes before the preferred charging window.

curl -X POST https://api.chargeapi.co/v1/reservations \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "connector_type": [
    "CCS"
  ],
  "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
  "ideal_end": "2026-04-01T02:45:43.318Z",
  "ideal_start": "2026-04-01T01:15:19.251Z",
  "location": {
    "latitude": 48.8698,
    "longitude": 2.3319,
    "radius": 1500
  },
  "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}'

{
    "id": "res_BzPpVflI7WIwvfvbLAU7MwYvKweypDnW",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": null,
    "confirmed_at": null,
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:15:05.782Z",
    "currency": "eur",
    "driver": "drv_MrLs3VDRkma7gHAcmQ8InEi8CKZ91hrS",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T02:45:43.318Z",
    "ideal_start": "2026-04-01T01:15:19.251Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {},
    "payment_method": "pm_TLAK3sXzk1KvcsyGLlU8nKAN05nrF7NV",
    "reservation_fee": 1200,
    "reserved_end": null,
    "reserved_start": null,
    "status": "pending",
    "updated": "2026-04-01T00:23:12.388Z",
    "vehicle": "veh_tnnvFIIM4oBXknF7qBVAy3biBlc0iKiv"
}

Parameters

string

required

ID of the driver creating the reservation.

string

required

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

string

required

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

string | null

Payment method ID for reservation fees.

string

required

ID of the vehicle to charge.

More parameters

array of string

required

Preferred connector types for charging.Available options: CHAdeMO, CCS, Type2

string | null

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

string | null

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

object

required

Geographic area within which Charge will attempt to assign 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.

Returns

Returns the created reservation.

Getting Started

API Behavior

API Reference

Create a Reservation

Parameters

More parameters

Returns

​Parameters

​More parameters

​Returns

Parameters

More parameters

Returns