---
title: "Returns the current load control settings of a system"
method: GET
path: "/api/v4/systems/config/{system_id}/load_control"
tags: ["System Configurations"]
---

# Returns the current load control settings of a system

`GET /api/v4/systems/config/{system_id}/load_control`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/config/{system_id}/load_control`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/config/:system_id/load_control/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current load control settings of a system

## Path parameters

- `system_id` string, required

## Response `200`

OK

- object
  - `system_id` integer
  - `load_control_data` object[]: load control data for all the configured loads
    - `name` string: Name of the dry contact
    - `load_name` string: Name of the load
    - `owner_can_override` string: HOs ability to override the load control settings
    - `mode` string: Current load control configuration
    - `soc_low` integer: Applicable for advanced mode. Load will be powered off when the battery soc reaches this level
    - `soc_high` integer: Applicable for advanced mode. Load powers off when battery reacheds soc_low. The load will be powered on when the battery soc reaches soc_high
    - `status` string: enabled/disabled
    - `essential_start_time` integer: Applicable for scheduled mode. Time in seconds. Load will powered on between essential_start_time and essential_end_time
    - `essential_end_time` integer: Applicable for scheduled mode. Time in seconds. Load will powered on between essential_start_time and essential_end_time

## Other responses

- `401`: Authentication Error
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `429`: Too Many Requests
- `501`: Not Implemented

---

[API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)