This guide covers what CPOs must send to and receive from ChargeIndia Hub.

Your responsibilities

As a CPO, you own charge points and publish operational data. The Hub aggregates your data for connected eMSPs based on routing rules.

Send to Hub (authenticated)

Module	Methods	What to push
Locations	`PUT`, `PATCH`	Locations, EVSEs, connectors
Tariffs	`PUT`	Pricing for your charge points
Sessions	`PUT`	Session state updates
CDRs	`POST`	Completed charge detail records

Push full location objects when creating or significantly changing a site. Use PATCH for incremental EVSE or connector status updates.

PUT /ocpi/2.2.1/locations/{country_code}/{party_id}/{location_id}

Push session state as charging progresses. Include cdr_token with the eMSP's country_code and party_id:

PUT /ocpi/2.2.1/sessions/{country_code}/{party_id}/{session_id}

Every session must include a valid cdr_token identifying the eMSP. Without it, the Hub cannot route async session updates to the correct eMSP.

After a session completes, POST the CDR:

POST /ocpi/2.2.1/cdrs

You must implement these receiver endpoints on your OCPI platform:

Module	Method	Purpose
Tokens	`PUT .../authorize`	Realtime token authorization from eMSP via Hub
Commands	`POST .../commands/{command}`	Remote start, stop, reserve, cancel
Versions	`GET /ocpi/versions`	Hub health monitoring

When an eMSP initiates charging, the Hub forwards authorization to you:

PUT /ocpi/2.2.1/tokens/{emsp_cc}/{emsp_pid}/{token_uid}/authorize

Respond with ALLOWED, BLOCKED, NOT_ALLOWED, or UNKNOWN.

The Hub forwards commands from eMSPs:

Command	Description
`START_SESSION`	Begin a charging session remotely
`STOP_SESSION`	End an active session
`RESERVE_NOW`	Reserve a connector
`CANCEL_RESERVATION`	Cancel a reservation

Return an immediate ACCEPTED or REJECTED response, then deliver async results via the Hub callback URL.

Async command results are sent to Hub (not directly to eMSP):

POST /ocpi/2.2.1/commands/callback/{command_id}

The Hub forwards the result to the eMSP's original response_url.

The Hub periodically probes GET /ocpi/versions on your platform. Ensure this endpoint is reachable and returns OCPI 2.2.1. See Connection Health.