Update a Reservation

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

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

string

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

string

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

More parameters

array of string

Updated acceptable connector types.Available options: CHAdeMO, CCS, Type2

string | null

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

string | null

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

object

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 updated reservation.

Getting Started

API Behavior

API Reference

Update a Reservation

Parameters

More parameters

Returns

​Parameters

​More parameters

​Returns

Parameters

More parameters

Returns