Petit Monde Energy Agent API
The Agent API enables third-party clients to search for EV charging locations across multiple CPO (Charge Point Operator) partners and make reservations programmatically.
Who is this for?
| Client Type | Description |
|---|---|
| EMP (E-Mobility Provider) | Consumer-facing apps that let drivers find and book chargers |
| Fleet Operator | Companies managing vehicle fleets with group-based charging |
| Corporate | Employee charging programs with usage tracking and reporting |
What can you do?
- Search — Find available chargers across all connected CPOs, filtered by location, connector type, and power
- Book — Reserve a specific EVSE (charger) for a time window using one of 4 token strategies
- Monitor — Track booking status through the full lifecycle (REQUESTED → CONFIRMED → COMPLETED)
- Cancel — Cancel bookings when plans change
Architecture
Your App ──→ Agent API ──→ EV Suite ──→ CPO Partners
(REST/JSON) (OCPI 2.2) (EnBW, Ionity, Allego, ...)
The Agent API is a unified REST interface. Behind it, EV Suite connects to CPO partners via OCPI 2.2, queries them in parallel, and returns aggregated results.
Base URLs
| Environment | URL |
|---|---|
| Production | https://api.petitmonde.energy/api/v1/client |
| Development | http://localhost:8084/api/v1/client |
Next Steps
- Quick Start — Make your first API call in 5 minutes
- Authentication — API keys, rate limits, and headers
- Choose your guide — EMP, Fleet, or Corporate integration path