Quickstart
Make your first authenticated call to the ProRanked platform API in a few minutes. Everything is one HTTPS base URL and one header.
The ProRanked API has two families that share the same base URL, auth, and conventions: CPMS (operator control plane — chargers, sessions, tariffs) and eMSP (driver & roaming — discovery, start/stop, payments). Pick the family that matches what you're building.
1. Get an API key
Create a key in the developer dashboard. Keys are prefixed pr_live_… (or pr_test_…). Treat them like passwords — never ship them in client-side code.
2. Authenticate
Send your key as the X-API-Key header on every request. The base URL is the same for both families:
curl 'https://api.proranked.com/cpms/v1/chargers' \
-H 'X-API-Key: pr_live_…'
3. Read the response
Every successful response is a JSON envelope: a data payload plus success and a server timestamp. List endpoints add a pagination object.
{
"data": [ { "id": "4b2e9c10-…", "uid": "CP-IslaVerde-01", "status": "Available" } ],
"pagination": { "page": 1, "pageSize": 50, "total": 137, "totalPages": 3 },
"success": true,
"timestamp": "2026-06-19T18:42:09Z"
}