Skip to main content

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.

{
    "id": "est_4wAzX6Td1H9rgSOK1F04h6t8dAhMvCZO",
    "object": "estimation",
    "battery_level": 28,
    "battery_target_level": 80,
    "charging_station": "chst_AW4FwwMQVwSaUWoKLgTZtlRjAUTdyA2t",
    "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-01T01:07:39.609Z",
    "currency": "eur",
    "estimated_duration": 3600,
    "estimated_energy_kwh": 18.25,
    "estimated_total_cost": 1842,
    "valid_until": "2026-04-01T02:07:52.218Z",
    "vehicle": "veh_gSUxpyILI2YhUOvd5jcGDyKA4sriI7t7"
}

{
    "id": "est_4wAzX6Td1H9rgSOK1F04h6t8dAhMvCZO",
    "object": "estimation",
    "battery_level": 28,
    "battery_target_level": 80,
    "charging_station": "chst_AW4FwwMQVwSaUWoKLgTZtlRjAUTdyA2t",
    "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-01T01:07:39.609Z",
    "currency": "eur",
    "estimated_duration": 3600,
    "estimated_energy_kwh": 18.25,
    "estimated_total_cost": 1842,
    "valid_until": "2026-04-01T02:07:52.218Z",
    "vehicle": "veh_gSUxpyILI2YhUOvd5jcGDyKA4sriI7t7"
}
This object represents an estimate in Charge. It previews the expected cost, duration, and energy use for a potential charging session.

​
Attributes

​
id
string
Unique identifier for the object.
​
battery_level
integer
Current battery level of the vehicle before charging, as a percentage (0–100).
​
battery_target_level
integer
Target battery level for this session, as a percentage (0–100).
​
charging_station
string
ID of the charging station used for the estimate.
​
cost_breakdown
array of object
Itemized list of costs included in the estimate.
​
estimated_duration
integer
Estimated charging duration in seconds.
​
estimated_total_cost
integer
Total estimated cost for the session in the smallest currency unit.
​
valid_until
string
Expiration timestamp for this estimate. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
vehicle
string
ID of the vehicle used for the estimate.

​
More attributes

​
object
string
String representing the object’s type.
​
created
string
Time at which the estimate was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
currency
string
ISO 4217 three-letter currency code.
​
estimated_energy_kwh
number
Estimated energy needed to reach the target battery level, in kilowatt-hours (kWh).