Set a charging profile on a partner session (2.2.1 / 2.3.0)

PUT

https://api.ocpplab.io/ocpi/emsp/:version/sessions/:session_id/charging-profile

PUT

/ocpi/emsp/:version/sessions/:session_id/charging-profile

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.ocpi.emsp.setChargingProfile({
        version: "221",
        session_id: "SES-20260930-0001",
        partner_id: 7,
        charging_profile: {
            charging_rate_unit: "A",
            charging_profile_period: [
                {
                    start_period: 0,
                    limit: 16,
                },
                {
                    start_period: 3600,
                    limit: 32,
                },
            ],
        },
    });
}
main();

{
  "partner_id": 7,
  "operation": "SET",
  "session_id": "SES-20260930-0001",
  "result": "ACCEPTED",
  "timeout": 30,
  "http_status": 200,
  "ocpi_status_code": 1000,
  "duration_ms": 95
}

Asks the CPO to apply a charging profile to a session it runs. The CPO answers asynchronously. OCPI 2.2.1 and 2.3.0 only.

Authentication

AuthorizationBearer

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

Path parameters

versionenumRequired

OCPI version: 221 (2.2.1) or 230 (2.3.0). OCPI 2.1.1 has no charging profiles or charging preferences.

Allowed values:

session_idstringRequired1-36 characters

Query parameters

partner_idintegerRequired>=1

Roaming partner to talk to (from GET /ocpi/partners).

Request

This endpoint expects an object.

charging_profileobjectRequired

OCPI ChargingProfile (same shape in 2.2.1 and 2.3.0).

Response

Successful Response

partner_idinteger or nullOptional

operationstring or nullOptional

session_idstring or nullOptional

resultstring or nullOptional

response_resultstring or nullOptional

timeoutinteger or nullOptional

http_statusinteger or nullOptional

ocpi_status_codeinteger or nullOptional

duration_msinteger or nullOptional

errorstring 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