curl -X POST https://api.chargeapi.co/v1/vehicles \
-H "Authorization: Bearer ch_sk_test_..." \
--json '{
"battery_capacity": 82000,
"charging_standard": "CCS",
"vin": "YV1XZK5V0S1234567"
}'
{
"id": "veh_6bPnSSnEUP1wKOBC0wOE2fsOsAzjZQDp",
"object": "vehicle",
"battery_capacity": 82000,
"charging_standard": "CCS",
"created": "2026-04-01T00:17:03.543Z",
"drivers": [],
"fleet": null,
"information": {
"make": "Volvo",
"model": "EX30",
"year": "2025"
},
"metadata": {},
"policy_ids": [],
"registration_plate": "AB-123-CD",
"status": "active",
"telemetry": "vtel_7zoXnXktRRzW0xIZv8dEUy4jFWDZ3rDp",
"updated": "2026-04-01T00:25:05.882Z",
"vin": "YV1XZK5V0S1234567"
}
Vehicles
Create a Vehicle
curl -X POST https://api.chargeapi.co/v1/vehicles \
-H "Authorization: Bearer ch_sk_test_..." \
--json '{
"battery_capacity": 82000,
"charging_standard": "CCS",
"vin": "YV1XZK5V0S1234567"
}'
{
"id": "veh_6bPnSSnEUP1wKOBC0wOE2fsOsAzjZQDp",
"object": "vehicle",
"battery_capacity": 82000,
"charging_standard": "CCS",
"created": "2026-04-01T00:17:03.543Z",
"drivers": [],
"fleet": null,
"information": {
"make": "Volvo",
"model": "EX30",
"year": "2025"
},
"metadata": {},
"policy_ids": [],
"registration_plate": "AB-123-CD",
"status": "active",
"telemetry": "vtel_7zoXnXktRRzW0xIZv8dEUy4jFWDZ3rDp",
"updated": "2026-04-01T00:25:05.882Z",
"vin": "YV1XZK5V0S1234567"
}
Creates a vehicle. Vehicles store identity, battery, telemetry, and charging-session context.
curl -X POST https://api.chargeapi.co/v1/vehicles \
-H "Authorization: Bearer ch_sk_test_..." \
--json '{
"battery_capacity": 82000,
"charging_standard": "CCS",
"vin": "YV1XZK5V0S1234567"
}'
{
"id": "veh_6bPnSSnEUP1wKOBC0wOE2fsOsAzjZQDp",
"object": "vehicle",
"battery_capacity": 82000,
"charging_standard": "CCS",
"created": "2026-04-01T00:17:03.543Z",
"drivers": [],
"fleet": null,
"information": {
"make": "Volvo",
"model": "EX30",
"year": "2025"
},
"metadata": {},
"policy_ids": [],
"registration_plate": "AB-123-CD",
"status": "active",
"telemetry": "vtel_7zoXnXktRRzW0xIZv8dEUy4jFWDZ3rDp",
"updated": "2026-04-01T00:25:05.882Z",
"vin": "YV1XZK5V0S1234567"
}
Parameters
object
string
License-plate / registration number.
string
required
Vehicle Identification Number (VIN).
More parameters
integer
required
Battery capacity in watt-hours (Wh).
string
required
Primary charging standard supported.Available options:
CCS, CHAdeMO, Type2object
Set of key-value pairs that you can attach to an object.