EV requests energy | OCPPLab Docs

import requests
url = "https://host.com/ocpp/commands/ev-requests-energy"
payload = {
    "target": { "charger_id": "dep-789" },
    "event": {
        "evse_id": 2,
        "connector_id": 1
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "targeted_count": 1,
  "queued_count": 1,
  "failed_count": 0,
  "results": [
    {
      "charger_id": "dep-789",
      "identity": "CP-ALPHA-007",
      "command": {
        "id": "f4e5d6c7b8a9",
        "event_type": "ev_requests_energy",
        "ocpp_version": "ocpp2.0.1",
        "payload": {
          "evse_id": 2,
          "connector_id": 1
        }
      }
    }
  ],
  "failed": []
}

Signal that the EV is ready to accept energy (ISO 15118 / OCPP 2.0.1 EV communication). The charger transitions to the Charging state on the specified connector. Targets a single charger, selected chargers in a location, or all chargers in a location.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

targetobjectRequired

Target for a unified command.

Provide exactly one of charger_id or location_id. charger_ids is an optional subset filter — only valid with location_id.

Examples::

{“charger_id”: “dep-123”} {“location_id”: “loc-456”} {“location_id”: “loc-456”, “charger_ids”: [“dep-1”, “dep-2”]}

eventobjectRequired

Command payload for connector-scoped actions.

Response

Command accepted and queued for the target charger(s)

targeted_countinteger

queued_countinteger

failed_countinteger

resultslist of objects

failedlist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error