Set or clear a charger's input limit

POST

https://api.ocpplab.io/energy-management/control-requests

POST

/energy-management/control-requests

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.energy.controlRequests.create({
        idempotencyKey: "limit-cp-ams-001-2026-10-03T10:00",
        charge_point_id: "CP-AMS-001",
        action: "SET_EVSE_INPUT_LIMIT",
        connector_id: 0,
        limit: 11000,
        unit: "W",
        valid_to: new Date("2026-10-03T18:00:00Z"),
    });
}
main();

{
  "request_id": "6b1f2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
  "charge_point_id": "CP-AMS-001",
  "connector_id": 0,
  "action": "SET_EVSE_INPUT_LIMIT",
  "result": "PENDING",
  "created_at": "2026-10-03T10:00:00Z",
  "limit": 11000,
  "unit": "W",
  "valid_to": "2026-10-03T18:00:00Z",
  "tracking_id": "8f4e2a1c-6b3d-4c5e-9a7f-1b2c3d4e5f60"
}

Sends an OCPP charging profile to the charger. The result is PENDING until the charger answers: read it back with GET /energy-management/control-requests/{request_id}, or subscribe a webhook to energy.control_response.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

charge_point_idstringRequired1-36 characters

actionenumRequired

Set or clear a charger input limit.

Allowed values:

connector_idinteger or nullOptional>=0Defaults to 0

limitdouble or nullOptional>=0

unitenum or nullOptional

Watts or amps.

Allowed values:

valid_todatetime or nullOptional

Response

The request, PENDING until the charger answers.

request_idstring

charge_point_idstring

connector_idinteger

actionenum or any

resultenum or any

created_atdatetime

limitdouble or nullOptional

unitenum or any or nullOptional

valid_todatetime or nullOptional

detailstring or nullOptional

tracking_idstring or nullOptional

completed_atdatetime or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error

Authentication

Headers

Request

Response

Errors