Built for developers & AI agents

One API to run EV charging — built for agents.

Charge point management, driver billing, and OCPI roaming through a single REST API. Deterministic JSON, scoped keys, and an LLM-native design — so your developers and your agents can ship.

$ npm i @proranked/node
api.proranked.comcpms
"start a session at Isla Verde, bay 1"
tool cpms.chargers.remoteStart
POST/cpms/v1/chargers/4b2e…/remote-start
{
"data": {
"chargerId": "4b2e9c10-…",
"c
dispatching to station…

Works with the AI stack your team already builds on

OpenAIClaudeCursorPerplexityLovableBase44LangChainHugging FaceMistral AIOpenAIClaudeCursorPerplexityLovableBase44LangChainHugging FaceMistral AIOpenAIClaudeCursorPerplexityLovableBase44LangChainHugging FaceMistral AIOpenAIClaudeCursorPerplexityLovableBase44LangChainHugging FaceMistral AI
The platform

Three APIs. One platform.

The full e-mobility stack — operate hardware, bill drivers, and roam across networks — behind one base URL and one auth model.

cpms.v1OCPP 1.6 · 2.0.1

CPMS API

The operator control plane. Manage chargers and connectors, push live OCPP commands, and run smart charging across your networks.

Remote start / stop / reboot
Smart charging & load balancing
OTA firmware & diagnostics
View reference →
emsp.v1Backend-as-a-Service

eMSP API

The e-mobility backend. Driver identity, authorization, sessions, and billing — so you ship charging apps without building the backend.

Driver identity & tokens
Sessions & invoicing
Cross-network discovery
View reference →
ocpi.v1OCPI 2.2

OCPI Roaming

Connect to roaming hubs and partner networks over standard OCPI. Locations, tariffs, sessions, and CDRs — normalized.

Locations & tariffs
Remote commands
CDR reconciliation
View reference →
✦ Agent-native

Designed for AI agents from the first endpoint.

Every endpoint ships with an LLM-ready spec, a deterministic response envelope, and scoped credentials — so an agent can discover, call, and verify without guesswork.

✦ COPY FOR LLM

LLM-ready specs

Every endpoint exposes a clean, copy-paste spec block built for context windows. Point your agent at the docs and go.

cpms:*

Scoped keys

Mint keys against the cpms:* scope vocabulary — give an agent exactly the permissions it needs, read-only or full control.

{ data }

Deterministic envelope

Every response is { data, success, timestamp }. Predictable to parse, easy to validate, safe to chain.

SSE

Live event stream

Subscribe to real-time charger, session, and status events — agents react the instant state changes.

POST/cpms/v1/api-keysmint a scoped key
{
"name": "Dispatch agent",
"scopes": [
"cpms:chargers:control",
"cpms:analytics:read"
],
"rateLimitPerHour": 5000
}
201 Createdsecret shown once
{
"data": {
"keyPrefix": "pk_cpms_live_",
"key": "pk_cpms_live_3f9a2c8e…",
"last4": "a1b2"
},
"success": true
}
Built for production

The whole operator toolkit, one integration.

Real OCPP control, smart charging, billing, and analytics — the primitives a charging network actually runs on.

Live OCPP control

Remote start/stop, reboot, unlock, and change availability over OCPP 1.6 and 2.0.1 — straight from an API call.

Smart charging

Per-connector limits, composite schedules, and station-level load balancing with on-demand rebalance.

Tariffs & CDRs

Pricing, assignments, a full transaction ledger, and CSV export for reconciliation and payouts.

Analytics & SLA

Revenue, energy, sessions, utilization, and uptime rollups — scoped per network, ready for dashboards.

Webhooks & SSE

Signed webhook subscriptions plus a real-time SSE stream, with delivery history and retries.

Fraud & identity

Driver phone verification, fraud holds, and outstanding-balance checks before a session ever starts.

Quickstart

Your first call, in under a minute.

Authenticate with a single X-API-Key. Same resource model in every SDK.

curl https://api.proranked.com/cpms/v1/analytics/kpis \
-H "X-API-Key: pr_live_…"
200 OKapplication/json
{
"data": {
"metric": "kpis",
"totalSessions": 7421,
"totalEnergyKwh": 54210.4,
"totalRevenue": 18432.55,
"avgDurationMinutes": 46.7,
"networkCount": 2
},
"success": true,
"timestamp": "2026-06-20T18:42:09Z"
}
API reference

A REST API you already know how to use.

Resource-oriented URLs, JSON everywhere, standard verbs, idempotency keys, and structured errors — across all three families.

GET/cpms/v1/meKey scopes & accessible networks
GET/cpms/v1/chargersList the operator’s chargers + live status
POST/cpms/v1/chargers/{id}/remote-startRemote-start a charging session
POST/cpms/v1/chargers/{id}/remote-stopRemote-stop an active session
PUT/cpms/v1/smart-charging/{id}/limitSet a per-connector charging limit
GET/cpms/v1/analytics/kpisRevenue, energy, sessions, avg duration
GET/cpms/v1/events/streamReal-time SSE event stream
POST/cpms/v1/api-keysMint a scoped API key
View the full CPMS reference
Specifications & certifications

Certified, standards-first, production-grade.

Built on the open standards the charging industry runs on — independently certified and security-hardened end to end.

OCPP 1.6 Core Certified

Independently certified by the Open Charge Alliance.

OCPP 2.0.1Supported

Full device model, SetVariables / GetVariables, and smart charging profiles.

OCPI 2.2Roaming

Locations, tariffs, sessions, and CDRs across partner networks.

Security Profiles 1–3OCPP

From ws:// + Basic auth up to wss:// with mutual TLS.

ISO 15118Ready

Plug & Charge driver identification support.

TLS 1.3 / mTLSSigned webhooks99.99% uptime SLAp95 < 120msSSE real-timeIdempotency keys

Build EV charging into your product — in days.

Live API keys in seconds. Scoped credentials for every agent and service. Generous free tier, no card required.

$ curl https://api.proranked.com/cpms/v1/me -H "X-API-Key: pr_live_…"