---
title: "Start or stop charging an electric vehicle. Please contact us to request early access."
method: POST
path: "/vehicles/{vehicle_id}/charge"
tags: ["Evs"]
---

# Start or stop charging an electric vehicle. Please contact us to request early access.

`POST /vehicles/{vehicle_id}/charge`

__Description__

Returns the current charge status of an electric vehicle.

__Permission__

`read_charge`

__Response body__

|  Name 	|Type   	|Boolean   	|
|---	|---	|---	|
|  `isPluggedIn` 	|   boolean	|  Indicates whether a charging cable is currently plugged into the vehicle’s charge port. 	|
|   `state`	|   string	|   Indicates whether the vehicle is currently charging. Options: `CHARGING` `FULLY_CHARGED` `NOT_CHARGING`	|

## Request body

- ChargeAction
  - `action` 'START' | 'STOP'

## Response `200`

return Success Response

- SuccessResponse
  - `status` 'SUCCESS' | 'FAILED'
  - `message` string, nullable

---

[API](https://skmtc.net/smartcar/apis/smartcar-api.md) · [All operations](https://skmtc.net/smartcar/apis/smartcar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartcar/smartcar-api/revisions/2101455240dc/schema)