Skip to main contentSkip to navigationSkip to search
Skip to main content
Learning Hub/Explorer
Back

Charging Profiles

OCPI 2.2.1
Overview

Smart charging lets a party shape how fast a car charges over time, sending a limit on power or current to a running session instead of a fixed target. Charge points sit on slow links, so the module works asynchronously like Commands: the sender requests a profile, the receiver acknowledges it can forward the request, and the real result arrives later as a POST to a response URL.

Who sends

EMSP or Smart Charging Provider (Sender)

Who receives

CPO (Receiver)

Key Fields
FieldTypeDescription

start_date_time

DateTime

Start of an absolute profile; if absent it is relative to charging start

duration

int

Length of the profile in seconds

charging_rate_unit

ChargingRateUnit

W (power) or A (current per phase)

charging_profile_period

ChargingProfilePeriod[]

Maximum power or current usage over time

response_url

URL

Where the asynchronous result is POSTed back

Endpoints
GET

/ocpi/2.2.1/chargingprofiles/{session_id}

PUT

/ocpi/2.2.1/chargingprofiles/{session_id}

DELETE

/ocpi/2.2.1/chargingprofiles/{session_id}

Live Endpoint Tester

Send requests directly to the local backend and see the response.

Skip to main content