Skip to main content
curl -X POST https://api.chargeapi.co/v1/reservations/res_wrF0i5e6cAuXxV9ojAl7Bj0ItaN2d2SI \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "metadata": {
    "dispatch_id": "dispatch_2048"
  }
}'

{
    "id": "res_wrF0i5e6cAuXxV9ojAl7Bj0ItaN2d2SI",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": "chst_EWmDp4B9TCVM6SFNP8dqqzCpzHsqh0zV",
    "confirmed_at": "2026-04-01T00:53:49.009Z",
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:25:49.017Z",
    "currency": "eur",
    "driver": "drv_MYExnPHAPwjl5AFEAoAAxgCpKSAqreju",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T02:55:47.067Z",
    "ideal_start": "2026-04-01T01:25:20.728Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {
        "dispatch_id": "dispatch_2048",
        "trip_id": "trip_9384"
    },
    "payment_method": "pm_QzTUskWh9JcjSzOpnAvccTNKE0lAHz3K",
    "reservation_fee": 1200,
    "reserved_end": "2026-04-01T02:55:54.025Z",
    "reserved_start": "2026-04-01T01:25:30.800Z",
    "status": "confirmed",
    "updated": "2026-04-01T00:59:15.857Z",
    "vehicle": "veh_yophwhitse33A4AGAF4lmU9meQ2Ou9I0"
}
Updates a reservation. Only reservations in pending status can be updated. 
curl -X POST https://api.chargeapi.co/v1/reservations/res_wrF0i5e6cAuXxV9ojAl7Bj0ItaN2d2SI \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "metadata": {
    "dispatch_id": "dispatch_2048"
  }
}'

{
    "id": "res_wrF0i5e6cAuXxV9ojAl7Bj0ItaN2d2SI",
    "object": "reservation",
    "cancellation_policy": {
        "free_until_before": 1800,
        "type": "free_cancellation"
    },
    "charging_station": "chst_EWmDp4B9TCVM6SFNP8dqqzCpzHsqh0zV",
    "confirmed_at": "2026-04-01T00:53:49.009Z",
    "connector_type": ["CCS"],
    "created": "2026-04-01T00:25:49.017Z",
    "currency": "eur",
    "driver": "drv_MYExnPHAPwjl5AFEAoAAxgCpKSAqreju",
    "earliest_start": null,
    "failed_reason": null,
    "ideal_end": "2026-04-01T02:55:47.067Z",
    "ideal_start": "2026-04-01T01:25:20.728Z",
    "latest_end": null,
    "location": {
        "latitude": 48.8698,
        "longitude": 2.3319,
        "radius": 1500
    },
    "metadata": {
        "dispatch_id": "dispatch_2048",
        "trip_id": "trip_9384"
    },
    "payment_method": "pm_QzTUskWh9JcjSzOpnAvccTNKE0lAHz3K",
    "reservation_fee": 1200,
    "reserved_end": "2026-04-01T02:55:54.025Z",
    "reserved_start": "2026-04-01T01:25:30.800Z",
    "status": "confirmed",
    "updated": "2026-04-01T00:59:15.857Z",
    "vehicle": "veh_yophwhitse33A4AGAF4lmU9meQ2Ou9I0"
}

​
Parameters

​
ideal_end
string
Updated preferred end time for charging. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
ideal_start
string
Updated preferred start time for charging. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

​
More parameters

​
connector_type
array of string
Updated acceptable connector types.Available options: CHAdeMO, CCS, Type2
​
earliest_start
string | null
Updated earliest acceptable start time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
latest_end
string | null
Updated latest acceptable end time. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
location
object
Geographic area within which Charge will attempt to assign a station.
​
metadata
object
Set of key-value pairs that you can attach to an object.

​
Returns

Returns the updated reservation.