---
title: "Get scheduling state"
method: GET
path: "/api/chargers/{chargerId}/schedules"
tags: ["State"]
---

# Get scheduling state

`GET /api/chargers/{chargerId}/schedules`

Get the charger's scheduling state.

## Path parameters

- `chargerId` string, required

## Response `200`

- ChargeSchedulingAPIGetScheduleStateResponse
  - `enabled` string — The enabled schedule type or 'none' if no schedule is enabled for the charger.
  - `delayed` ChargeSchedulingAPIDelayedScheduleModel
    - `timezone` string — IANA time zone identifier for the schedule.
    - `startTime` string, time — Start time of the charging schedule.
    - `maximumAmps` integer — The maximum electrical current in amperes available to the vehicle throughout the charging schedule.
  - `daily` ChargeSchedulingAPIDailyScheduleModel
    - `timezone` string — IANA time zone identifier for the schedule.
    - `periods` ChargeSchedulingAPIDailySchedulePeriod[] — Collection of time periods during which charging is permitted.
      - `startTime` string, time — Start time of the charging period.
      - `stopTime` string, time — Stop time of the charging period.
      - `maximumAmps` integer — The maximum electrical current in amperes permitted by the schedule during this charging period.
  - `weekly` ChargeSchedulingAPIWeeklyScheduleModel
    - `timezone` string — IANA time zone identifier for the schedule.
    - `periods` ChargeSchedulingAPIWeeklySchedulePeriod[] — Collection of time periods during which charging is permitted.
      - `startDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `startTime` string, time — The time of day on which the schedule period begins.
      - `stopDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `stopTime` string, time — The time of day on which the schedule period ends.
      - `maximumAmps` integer — The maximum electrical current in amperes permitted by the schedule during this charging period.
  - `offPeak` ChargeSchedulingAPIOffPeakScheduleModel
    - `timezone` string — IANA timezone identifier of timezone to use for the schedule.
    - `template` string — The off-peak template the schedule is based on.
    - `randomizedDelay` ChargeSchedulingAPIOffPeakRandomizedDelay
      - `enabled` boolean — Whether randomized delay is enabled for the schedule.
      - `maximumSeconds` integer, nullable — The configured maximum delay in seconds for the schedule.
      - `actualSeconds` integer, nullable — The actual randomized delay offset calculated for this schedule.
    - `periods` ChargeSchedulingAPIOffPeakSchedulePeriod[] — Collection of time periods during which charging is permitted.
      - `startDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `startTime` string, time — The time of day on which the schedule period begins.
      - `stopDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `stopTime` string, time — The time of day on which the schedule period ends.
      - `maximumAmps` integer — The maximum electrical current in amperes permitted by the schedule during this charging period.
  - `tariff` ChargeSchedulingAPITariffScheduleModel
    - `timezone` string — IANA time zone identifier for the schedule.
    - `priceCap` number — The maximum electricity price set for the schedule.
    - `periods` ChargeSchedulingAPITariffSchedulePeriod[] — Collection of upcoming time periods during which charging is permitted.
      - `startDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `startTime` string, time — The time of day on which the schedule period begins.
      - `stopDay` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday'
      - `stopTime` string, time — The time of day on which the schedule period ends.
      - `maximumAmps` integer — The maximum electrical current in amperes permitted by the schedule during this charging period.

## Other responses

- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/easee/apis/easee-cloud-api.md) · [All operations](https://skmtc.net/easee/apis/easee-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easee/easee-cloud-api/revisions/46ccab4af8b1/schema)