POST
/
estimations
curl --request POST \
  --url https://api.chargeapi.co/v1/estimations
{
  "id": null,
  "object": null,
  "battery_level": null,
  "battery_target_level": null,
  "cost_breakdown": [
    {
      "cost": null,
      "description": null,
      "quantity": null,
      "type": null,
      "unit": null,
      "unit_price": null,
      "tax_percent": null
    }
  ],
  "created": null,
  "currency": null,
  "estimated_duration": null,
  "estimated_energy_kwh": null,
  "estimated_total_cost": null,
  "charging_station": null,
  "valid_until": null,
  "vehicle": null
}

Response

200 - application/json
A newly created estimation.

An Estimation represents a real-time cost preview for a potential charging session. It helps drivers and platforms understand the expected cost and duration of a session before it begins, based on the vehicle's current battery level, charging goal, pricing, and station conditions.

​
id
string

Unique identifier for the estimation object.

Example:

null

​
object
string

String representing the object’s type. Always estimation.

Example:

null

​
battery_level
integer

Current battery level of the vehicle before charging, as a percentage (0–100).

Example:

null

​
battery_target_level
integer

Target battery level for this session, as a percentage (0–100).

Example:

null

​
cost_breakdown
object[]

Itemized list of costs included in the estimate, such as energy, session, and idle fees.

​
created
integer

Time at which the estimation was generated.

Example:

null

​
currency
string

ISO 4217 three-letter currency code (e.g., usd).

Example:

null

​
estimated_duration
integer

Estimated charging duration in seconds.

Example:

null

​
estimated_energy_kwh
number

Estimated energy needed to reach the target battery level, in kilowatt-hours (kWh).

Example:

null

​
estimated_total_cost
number

Total estimated cost for the session in currency units.

Example:

null

​
charging_station
string

ID of the charging station used for this estimation.

Example:

null

​
valid_until
integer

Expiration timestamp for this estimate. The values may change after this point.

Example:

null

​
vehicle
string

ID of the vehicle used for the estimation.

Example:

null