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

PUT

https://api.ev-cloud.ai/ocpi/emsp/:version/sessions/:session_id/charging-profile

PUT

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

import { EvcloudSDK } from "evcloud-sdk";
async function main() {
    const client = new EvcloudSDK({
        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: the roaming_partner_id from GET /ocpi/partners, not its id.

to_country_codestring or nullOptionalformat: "^[A-Za-z]{2}$"=2 characters

Partner is a Hub: country code of the CPO behind it (OCPI-to-country-code). Set together with to_party_id; through a Hub the request is refused (400) when neither is set and the target is not cached.

to_party_idstring or nullOptionalformat: "^[A-Za-z0-9]{3}$"=3 characters

Partner is a Hub: party id of the CPO behind it (OCPI-to-party-id). Set together with to_country_code.

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