Get this EV charger's schedule - Amps AI Documentation

GET

ev-charger

{deviceId}

schedule

curl

curl --request GET \
  --url 'https://api.amps.ai/ev-charger/device_abc123/schedule' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'

{
  "id": "sched_abc123",
  "deviceId": "device_abc123",
  "deviceType": "ev_charger",
  "state": "active",
  "timezone": "Europe/London",
  "recurrence": {
    "rule": "daily"
  },
  "slots": [
    {
      "time": "00:30",
      "duration": "PT5H",
      "command": "charge",
      "parameters": {
        "target": {
          "value": 100,
          "unit": "percent"
        }
      }
    }
  ],
  "updatedAt": "2026-06-01T12:00:00.000Z",
  "nextFireAt": "2026-06-02T00:30:00.000Z"
}

Authorizations

x-api-key

string

header

required

Path Parameters

deviceId

string

required

The unique identifier for the EV Charger device.

Example:

"device_abc123"

Response

The device's active schedule, or null when none is set.

Set this EV charger's scheduleSet or replace the schedule on this EV charger. The schedule's contents are device config, so they are written on the device itself rather than posted to a separate resource. The body is a non-empty `slots` array (each slot an `at` absolute-timestamp variant or a `time` wall-clock variant), an optional `recurrence` rule, and a schedule-level IANA `timezone` for `time`-variant slots. The route is published ahead of the scheduler; every call returns 501 until it lands.

curl

curl --request GET \
  --url 'https://api.amps.ai/ev-charger/device_abc123/schedule' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'

{
  "id": "sched_abc123",
  "deviceId": "device_abc123",
  "deviceType": "ev_charger",
  "state": "active",
  "timezone": "Europe/London",
  "recurrence": {
    "rule": "daily"
  },
  "slots": [
    {
      "time": "00:30",
      "duration": "PT5H",
      "command": "charge",
      "parameters": {
        "target": {
          "value": 100,
          "unit": "percent"
        }
      }
    }
  ],
  "updatedAt": "2026-06-01T12:00:00.000Z",
  "nextFireAt": "2026-06-02T00:30:00.000Z"
}