Tariffs (eMSP)

Pull tariffs from ChargeIndia Hub and receive async tariff updates.

Hub role: SENDER (eMSP pull + async PUT push to eMSP RECEIVER)

When a CPO PUTs a tariff, you receive PUT on your tariffs RECEIVER URL. See Async Delivery.

Endpoints

MethodPathDescription
GET/ocpi/2.2.1/tariffsList tariffs (paginated)
GET/ocpi/2.2.1/tariffs/{cc}/{pid}/{tariff_id}Tariff detail
PUTYour tariffs RECEIVER URLAsync tariff updates from Hub

Receiver path party

Async pushes from Hub use the owning CPO's country_code and party_id in the URL path, not Hub (CIH). See Hub Receiver Identity (eMSP).

Pull example

GET /ocpi/2.2.1/tariffs?offset=0&limit=50&date_from=2024-01-01T00:00:00Z
Authorization: Token {emsp-token}

Results are ordered by last_updated descending and filtered by routing rules. Optional date_from supports incremental sync. Responses include a Link header for pagination (same pattern as locations). See Pagination.

Use tariffs for authorization pricing context. See India Conventions for INR requirements.

OCPI spec

See OCPI 2.2.1 Tariffs module for full Tariff object definitions.