Ampère API: Insight, forecast and control of smart devices

You're in control

The Ampère API provides comprehensiv forecasting, control and monitoring capabilities for Chargee's smart energy devices. Get real-time data, control device states, and access both forecasts and historical usage patterns.

Get started today!

The Ampère API enables you to integrate with smart meters and smart devices on indidivual bases as well as on a whole. Gain access to comprehensive energy data and control your smart energy ecosystem with ease.

Device control

Control Sparky and Flint connected devices remotely. Turn devices on/off, adjust power, and manage device configurations through simple REST API calls. On individual bases or as a whole.

Insight and forecasting

Get real-time energy consumption and generation data, device status, and performance metrics. Monitor power usage, voltage, current, and other electrical parameters with sub-second precision. Get forecasts for your entire portfolio or for individual devices.

Historical Data

Access historical energy usage data with flexible time ranges. Analyze consumption patterns, generate reports, and build energy analytics dashboards for your users.

Some API examples

GET /v2/sparkies/{serial_number}/electricity/latest

Get the latest energy consumption and generation data for a specific Sparky.

[
    {
        "from": "2023-01-01T12:15:00+02:00",
        "to": "2023-01-01T12:30:00+02:00",
        "delivery_peak": 1.401,
        "delivery_off_peak": 1.02,
        "delivery": 2.421,
        "return_peak": 1.401,
        "return_off_peak": 1.02,
        "return": 2.421
    }
]

GET /api/v2/addresses/{address_uuid}/vehicles

Access all vehicles connected to a specific address.

[
    {
    "identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "vin": "XXXXXXXXXXXXXXXXX",
    "info": {
        "brand": "Tesla",
        "model": "Model S",
        "year": 2019,
        "lastSeen": 1713957514489
    },
    "lastLocation": {
        "location": {
        "lat": "00.000000",
        "lng": "00.000000"
        },
        "time": 1713957514489
    },
    "lastOdometer": {
        "km": 101,
        "time": 1713957514489
    },
    "lastChargeState": {
        "time": 1713957514489,
        "isFullyCharged": false,
        "isPluggedIn": false,
        "isCharging": false,
        "batteryLevel": 60,
        "range": 250,
        "batteryCapacity": 95,
        "chargeLimit": 80,
        "maxCurrent": 13,
        "powerDeliveryState": 3
    },
    "createdAt": 1713957514489,
    "updatedAt": 1713957514489,
    "deletedAt": 1713957514489
    }
]

GET /{solar_inverter_uuid}/production-forecast

Get a forecast for the production of a specific solar inverter.


[
    {
        "identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "solarInverterIdentifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "intervals": [
            "interval_data"
        ],
        "processedTime": 1713957514489,
        "modelType": "xgboost",
        "modelVersion": "v3"
    }
]

POST /api/v2/addresses/{address_uuid}/chargers

Get the latest charge state for a specific charger.


[
    {
        "identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "brand": "XXXXXXXXXXXXXXXXX",
        "model": "XXXXXXXXXXXXXXXXX",
        "year": 2025,
        "lastChargeState": {
            "time": 1713957514489,
            "isPluggedIn": false,
            "isCharging": false,
            "chargeRate": 11,
            "maxCurrent": 13,
            "powerDeliveryState": 3
        },
        "createdAt": 1713957514489,
        "updatedAt": 1713957514489,
        "deletedAt": 1713957514489
    }
]

Ready to integrate with Ampère API?

Start building with the Ampère API today. Get comprehensive documentation, interactive API explorer, and dedicated developer support.

Get API Access View Documentation