Skip to main content

Quick Start

Go from zero to your first API call in 5 minutes.

Prerequisites​

  • An API key (provided by your Petit Monde Energy account manager)
  • curl or any HTTP client

Step 1: Verify your API key​

curl -s https://api.petitmonde.energy/api/v1/client/me \
  -H "X-API-Key: YOUR_API_KEY" | jq .

You should see your account info:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "client_type": "EMP",
  "company_name": "Your Company",
  "status": "active",
  "api_rate_limit": 100,
  "api_monthly_quota": 10000,
  "current_minute_usage": 1,
  "current_month_usage": 42
}

Step 2: Search for chargers​

Search for EV chargers within 10km of Berlin:

curl -s "https://api.petitmonde.energy/api/v1/client/search?lat=52.52&lng=13.40&radius=10&limit=3" \
  -H "X-API-Key: YOUR_API_KEY" | jq .

Response:

{
  "results": [
    {
      "location_id": "DE-ENB-E123456",
      "cpo_name": "EnBW mobility+",
      "name": "EnBW Schnelllader Berlin Mitte",
      "address": "Friedrichstr. 100",
      "city": "Berlin",
      "distance_km": 0.8,
      "evses": [
        {
          "evse_uid": "DE*ENB*E123456*1",
          "status": "AVAILABLE",
          "connectors": [
            {
              "id": "1",
              "standard": "IEC_62196_T2_COMBO",
              "power_type": "DC",
              "max_electric_power": 350000
            }
          ]
        }
      ],
      "supports_reservation": true
    }
  ],
  "total": 42,
  "cpo_results": [
    {"cpo_name": "EnBW mobility+", "location_count": 23, "query_time_ms": 145},
    {"cpo_name": "IONITY", "location_count": 12, "query_time_ms": 203}
  ]
}

Step 3: Make a booking​

curl -s -X POST https://api.petitmonde.energy/api/v1/client/bookings \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "DE-ENB-E123456",
    "evse_uid": "DE*ENB*E123456*1",
    "connector_id": "1",
    "reservation_start": "2026-02-10T14:00:00Z",
    "reservation_end": "2026-02-10T16:00:00Z",
    "external_id": "my-ref-001"
  }' | jq .

The booking starts in REQUESTED status and transitions to CONFIRMED once the CPO accepts it.

Step 4: Check booking status​

curl -s https://api.petitmonde.energy/api/v1/client/bookings/BOOKING_ID \
  -H "X-API-Key: YOUR_API_KEY" | jq .status

What's next?​