> ## 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.

# The Estimation object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Estimation object theme={null}
    {
        "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"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Estimation object theme={null}
    {
        "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"
    }
    ```
  </ResponseExample>
</div>

This object represents an estimate in Charge. It previews the expected cost, duration, and energy use for a potential charging session.

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="battery_level" type="integer">
  Current battery level of the vehicle before charging, as a percentage (0–100).
</ResponseField>

<ResponseField name="battery_target_level" type="integer">
  Target battery level for this session, as a percentage (0–100).
</ResponseField>

<ResponseField name="charging_station" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the charging station used for the estimate.
</ResponseField>

<ResponseField name="cost_breakdown" type="array of object">
  Itemized list of costs included in the estimate.

  <Expandable title="properties">
    <ResponseField name="cost" type="integer">
      Total cost for this line item in the smallest currency unit.
    </ResponseField>

    <ResponseField name="description" type="string">
      Human-readable label for the line item.
    </ResponseField>

    <ResponseField name="quantity" type="number | null">
      Quantity of the unit, if applicable.
    </ResponseField>

    <ResponseField name="tax_percent" type="string | null">
      Optional tax rate or tax label applied to the item.
    </ResponseField>

    <ResponseField name="type" type="string">
      Type of the cost item.
    </ResponseField>

    <ResponseField name="unit" type="string | null">
      Unit of measurement, if applicable.
    </ResponseField>

    <ResponseField name="unit_price" type="integer | null">
      Price per unit for this item in the smallest currency unit, if applicable.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="estimated_duration" type="integer">
  Estimated charging duration in seconds.
</ResponseField>

<ResponseField name="estimated_total_cost" type="integer">
  Total estimated cost for the session in the smallest currency unit.
</ResponseField>

<ResponseField name="valid_until" type="string">
  Expiration timestamp for this estimate. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="vehicle" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the vehicle used for the estimate.
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the estimate was created. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="currency" type="string">
  ISO 4217 three-letter currency code.
</ResponseField>

<ResponseField name="estimated_energy_kwh" type="number">
  Estimated energy needed to reach the target battery level, in kilowatt-hours (kWh).
</ResponseField>