The Wevolt CPO API is a read-only REST API that lets Charge Point Operator (CPO) and Charge Point Manager (CPM) accounts pull operational data from the Wevolt platform without logging into the Hub. Use it for back-office work such as billing reconciliation, internal dashboards, and exports to a data warehouse.
Read-only, and keys are issued by Wevolt
The API only reads data. It cannot start, stop, or configure chargers. API keys are issued by Wevolt, not self-served. To request one, contact your account manager. See Getting API access below.
What the CPO API gives you
There are three data sets, each requested from the same base URL with a different value of the data parameter:
- Platform statistics — headline counts of chargers, app users, and transactions.
- Charging analytics — time-series data for energy, charging sessions, revenue, and averages.
- Transaction records — the per-station list of completed charging sessions, as JSON or CSV.
Endpoints
Platform statistics
Returns headline counts across your account: the number of AC and DC charging stations, app users, and the total and paid transaction counts. Useful for a quick top-of-dashboard summary.
Charging analytics
Returns time-series data over a timeframe you choose (today, week, month, year, or all time). Each series comes back with its values, totals, and a unit. The available metrics are:
| Metric | What it shows | Unit |
|---|---|---|
| Total energy consumption | Energy delivered over the period | kWh |
| Number of charges | Count of charging sessions | sessions |
| Charge point revenue | Revenue per charge point | cents |
| Average energy per charge | Mean energy delivered per session | kWh |
| Energy used per charge | Energy distribution across sessions | kWh |
| Average and length of time per charge | Session duration | time |
| Energy over time of day | Intraday energy pattern | kWh |
| Charges per day of week | Weekly seasonality | sessions |
Timestamps in the response are in UTC. The timezone you pass controls how the daily buckets align to local days.
Transaction records
Returns the list of completed charging sessions for a single charging station, filtered to a date range, as JSON or CSV. This is the most detailed data set. Each session record includes:
| Field group | What you get |
|---|---|
| Session | Transaction ID, how it was authorised (RFID, app, local token, eMSP), and the masked token or RFID card number |
| Location and charger | Site name, station ID, connector number, connector current (AC or DC), and plug type |
| Energy and time | Energy delivered (kWh), start and end times, charging duration, idle or parking time, and total occupancy time |
| Cost | Charging cost, idle or parking fee, and total cost for the session (gross, before refunds), all in cents |
Only settled sessions are returned
Transaction records include only completed, paid sessions. Sessions that are still settling, failed payment, or were marked invalid are not returned, even if they appear in the Hub Transactions tab.
Limits and boundaries
- Read-only. GET requests only. There is no control surface to start, stop, reset, or configure chargers, and no webhooks or push notifications. The API is poll-based.
- Daily request quota. Each key has a per-day request limit set by Wevolt. If you exceed it, requests are rejected until the rolling 24-hour window clears. Plan for this when looping over many stations.
- One station per call for transactions. There is no "all stations" endpoint and no endpoint that lists your station IDs. Find your station IDs in the Hub under Charger Management, then request transactions one station at a time.
- Row cap. Transaction requests return at most 10,000 sessions per call. For busy stations, request shorter date ranges (for example, one month at a time) and combine the results.
- UTC timestamps. All times in responses are in UTC. Convert to your local time on your side.
Getting API access
API keys are issued by Wevolt. To request a key for your CPO account, contact your account manager or email contact@wevolt.com.au. Treat your key as a secret: anyone with it can read all operational data for your account. If a key is ever exposed, contact us to have it replaced.
Still need help?
If you have a question this guide does not cover, get in touch and we will help you scope your integration.
- Email: contact@wevolt.com.au
- Website: wevolt.com.au
Related articles
- How to View Power Readings in Wevolt Sessions — see session energy data directly in the Hub, without the API.
- Technical support for Charge Point Operators — what is included with your licence and how to request paid help.
- How Do I Get Started? — the front door for new operators onboarding to Wevolt Hub.
Related Articles
Wevolt LMS site/charger onboarding guide
This guide provides the steps needed to configure load management for a site in Wevolt LMS. It covers site capacities, meter integration, charger and connector settings, phase assignments, and status monitoring, helping users streamline setup and ...How to View Power Readings in Wevolt Sessions
This guide shows you how to quickly access and understand power readings from your charging sessions in the Wevolt Hub. Follow these simple steps to find detailed energy data, track charging performance, and manage your sessions with ease. 1. Open ...Managing RFID Cards and Access in the Wevolt Hub
This guide is for Charge Point Operators and Managers. It explains how to add RFID cards, organise them into Groups, and control which of your sites they can use and at what price. If you only need to activate the cards from a card order, see How to ...Adding a Charger in Wevolt Hub
This guide provides a straightforward process for creating and configuring a charging station using the Wevolt Hub. It covers key steps, such as enabling load management and connecting the charger to the platform, ensuring optimal performance. By ...Adding New Location In Wevolt Hub
Locations are the exact spots where charging stations are available, along with key details like charger type, number of ports, real-time availability, pricing, and operating hours. This allows drivers to quickly locate nearby chargers, plan routes ...