Skip to main content

Frequently Asked Questions

General​

What regions are supported?​

Currently focused on Germany with EUR currency. Multi-region support is planned.

Which CPOs are connected?​

The network includes major operators like EnBW, IONITY, Allego, and others. The exact list depends on your contract. Use the search endpoint to see all available CPOs in a given area.

What's the difference between OCPI and the Agent API?​

OCPI is the protocol between EV Suite and CPOs (backend-to-backend). The Agent API is a simplified REST interface for your application — you don't need to understand OCPI.

Authentication​

I lost my API key. Can you resend it?​

No — API keys are hashed (bcrypt) and cannot be retrieved. Contact your account manager to generate a new key.

Can I have multiple API keys?​

Currently, one key per client account. If you need separate keys for staging and production, request two client accounts.

Can I rotate my API key?​

Contact your account manager. Key rotation generates a new key and invalidates the old one immediately.

How does multi-CPO search work?​

The Agent API queries all connected CPO partners in parallel and returns aggregated results sorted by distance. The cpo_results field shows per-CPO timing and counts.

Can I filter by specific CPOs?​

Not currently. You can filter results client-side using the cpo_name or cpo_party_id fields.

What does supports_reservation mean?​

Some locations are search-only — you can see them but not book. Only locations with supports_reservation: true accept bookings.

Bookings​

How long until a booking is confirmed?​

Typically 1–10 seconds. The CPO processes the reservation and sends confirmation via OCPI. Poll GET /bookings/{id} every 5 seconds.

What happens if I don't show up?​

The booking transitions to EXPIRED or NO_SHOW. Some CPOs charge a no-show fee.

Can I modify a booking?​

Not directly. Cancel the existing booking and create a new one.

What's the maximum reservation duration?​

Typically 4 hours, but it's CPO-dependent. If you request a window that's too long, the CPO may reject it.

When can I cancel without charge?​

Bookings in REQUESTED or PENDING status can always be cancelled without charge. CONFIRMED bookings may incur CPO-dependent cancellation fees.

Rate Limits​

What happens when I hit the monthly quota?​

All requests return 429 until the next calendar month. Contact your account manager to increase the quota.

Do rate limit headers count the current request?​

Yes — the X-RateLimit-Remaining value reflects the state after the current request.

Pricing​

How is client_price calculated?​

It includes the base CPO cost plus your configured reservation fee and commission percentage. This is the total you'll be invoiced.

Is pricing guaranteed?​

The client_price is an estimate at booking time. Final price may vary slightly based on actual session duration and energy consumed.