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

# Create a Vehicle

Creates a vehicle. Vehicles store identity, battery, telemetry, and charging-session context.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chargeapi.co/v1/vehicles \
    -H "Authorization: Bearer ch_sk_test_..." \
    --json '{
    "battery_capacity": 82000,
    "charging_standard": "CCS",
    "vin": "YV1XZK5V0S1234567"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "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"
  }
  ```
</ResponseExample>

## Parameters

<ParamField body="information" type="object">
  Manufacturer details for the vehicle.

  <Expandable title="properties">
    <ParamField body="make" type="string | null">
      Vehicle manufacturer or brand.
    </ParamField>

    <ParamField body="model" type="string | null">
      Model name of the vehicle.
    </ParamField>

    <ParamField body="year" type="string | null">
      Model year of the vehicle.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="registration_plate" type="string">
  License-plate / registration number.
</ParamField>

<ParamField body="vin" type="string" required>
  Vehicle Identification Number (VIN).
</ParamField>

## More parameters

<ParamField body="battery_capacity" type="integer" required>
  Battery capacity in watt-hours (Wh).
</ParamField>

<ParamField body="charging_standard" type="string" required>
  Primary charging standard supported.

  Available options: `CCS`, `CHAdeMO`, `Type2`
</ParamField>

<ParamField body="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ParamField>

## Returns

Returns the created vehicle.