Skip to main content
curl -X POST https://api.chargeapi.co/v1/estimations \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "battery_level": 28,
  "battery_target_level": 80,
  "charging_station": "chst_I0GVqyJwBI3Jwd4V6yIA009ZAgLOzTGm",
  "vehicle": "veh_f4zwAgxuAkNh6HHUDorkosY6md4BB7A2"
}'

{
    "id": "est_ru6IqQbvO5jXuKqAAuVX7ZevKKCHKyAJ",
    "object": "estimation",
    "battery_level": 28,
    "battery_target_level": 80,
    "charging_station": "chst_I0GVqyJwBI3Jwd4V6yIA009ZAgLOzTGm",
    "cost_breakdown": [
        {
            "cost": 1542,
            "description": "Off-peak energy rate",
            "quantity": 18.25,
            "tax_percent": "20%",
            "type": "energy",
            "unit": "kWh",
            "unit_price": 85
        },
        {
            "cost": 300,
            "description": "Session fee",
            "quantity": null,
            "tax_percent": null,
            "type": "session_fee",
            "unit": null,
            "unit_price": null
        }
    ],
    "created": "2026-04-01T00:46:52.360Z",
    "currency": "eur",
    "estimated_duration": 3600,
    "estimated_energy_kwh": 18.25,
    "estimated_total_cost": 1842,
    "valid_until": "2026-04-01T01:46:42.724Z",
    "vehicle": "veh_f4zwAgxuAkNh6HHUDorkosY6md4BB7A2"
}

Documentation Index

Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt

Use this file to discover all available pages before exploring further.

Creates a cost estimate for a proposed charging session. Provide the charging goal plus station and vehicle context to receive estimated energy, duration, and pricing. 
curl -X POST https://api.chargeapi.co/v1/estimations \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "battery_level": 28,
  "battery_target_level": 80,
  "charging_station": "chst_I0GVqyJwBI3Jwd4V6yIA009ZAgLOzTGm",
  "vehicle": "veh_f4zwAgxuAkNh6HHUDorkosY6md4BB7A2"
}'

{
    "id": "est_ru6IqQbvO5jXuKqAAuVX7ZevKKCHKyAJ",
    "object": "estimation",
    "battery_level": 28,
    "battery_target_level": 80,
    "charging_station": "chst_I0GVqyJwBI3Jwd4V6yIA009ZAgLOzTGm",
    "cost_breakdown": [
        {
            "cost": 1542,
            "description": "Off-peak energy rate",
            "quantity": 18.25,
            "tax_percent": "20%",
            "type": "energy",
            "unit": "kWh",
            "unit_price": 85
        },
        {
            "cost": 300,
            "description": "Session fee",
            "quantity": null,
            "tax_percent": null,
            "type": "session_fee",
            "unit": null,
            "unit_price": null
        }
    ],
    "created": "2026-04-01T00:46:52.360Z",
    "currency": "eur",
    "estimated_duration": 3600,
    "estimated_energy_kwh": 18.25,
    "estimated_total_cost": 1842,
    "valid_until": "2026-04-01T01:46:42.724Z",
    "vehicle": "veh_f4zwAgxuAkNh6HHUDorkosY6md4BB7A2"
}

​
Parameters

​
battery_level
integer
required
Current battery level of the vehicle before charging, as a percentage (0-100).
​
battery_target_level
integer
required
Target battery level for this session, as a percentage (0-100).
​
charging_station
string
required
ID of the charging station being evaluated.
​
vehicle
string
required
ID of the vehicle to use for battery capacity and connector checks.

​
More parameters

​
currency
string
Optional ISO 4217 currency code to override the station default.

​
Returns

Returns the created estimation.