Skip to main content
POST
EV Charging Cost Calculator

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ioBatteryCapacity
number

Battery Capacity (kWh)

Required range: 1 <= x <= 300
ioStartPercent
number

Start Charge (%)

Required range: 0 <= x <= 100
ioTargetPercent
number

Target Charge (%)

Required range: 0 <= x <= 100
ioRatePreset
enum<string>

Rate Preset

Available options:
custom,
0.16,
0.34,
0.25,
0.30,
0.13,
0.10
ioHomeRate
number

Home Rate ($/kWh)

Required range: x >= 0.001
ioPublicRate
number

Public Rate ($/kWh)

Required range: x >= 0
ioEfficiency
number

Vehicle Efficiency

Required range: x >= 0.1
ioDistanceUnit
enum<string>

Distance Unit

Available options:
km,
mi
ioDailyDistance
number

Avg Daily Distance

Required range: x >= 0

Response

Tool output

tool
string
required
tool_version
string
required

Output-contract version for this tool. Currently "1" for all tools.

outputs
object
required
credits_used
integer
required

Credits this call consumed, after any settlement refund. 0 when metering is disabled.

request_id
string
credits_remaining
integer | null

Credits left in the current monthly allowance, or null when metering is disabled.