Skip to main content
Version: 1.0.0

Petit Monde Energy Agent API

Overview​

The Agent API enables third-party clients (EMPs, Fleet Operators, Corporates) to search for charging locations across multiple CPO partners and make reservations programmatically.

Authentication​

All endpoints require API key authentication. Include your API key in the request header:

X-API-Key: your-api-key-here

Alternatively, use Bearer token format:

Authorization: Bearer your-api-key-here

Rate Limiting​

API requests are rate-limited per client:

  • Per-minute limit: Configured per client (default: 100 requests/minute)
  • Monthly quota: Configured per client (default: 10,000 requests/month)

Rate limit headers are included in every response:

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Requests remaining in current minute
  • X-RateLimit-Reset: ISO 8601 timestamp when the limit resets
  • Retry-After: Seconds to wait before retrying (only on 429 responses)

Error Handling​

All errors return a JSON object with an error field:

{
  "error": "Description of what went wrong"
}

Regional Support​

Currently focused on Germany (EUR currency, de-DE locale). Multi-region support planned.

Authentication​

Your API key. Obtain this from the EV Suite dashboard when creating a new Agent Client account.

Security Scheme Type:

apiKey

Header parameter name:

X-API-Key

Contact

Petit Monde Energy API Support: api-support@petitmonde.energy