Skip to main content
POST
/
ev-charger
/
{deviceId}
curl
curl --request POST \
  --url 'https://api.amps.ai/ev-charger/dev_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "action": "start_charging"
  }'
{
  "actionId": "act_2026050712000ev02",
  "state": "acknowledged",
  "type": "ev-charger:start_charging",
  "createdAt": "2026-05-07T12:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.amps.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
deviceId
string
required

The unique identifier for the EV Charger device

Example:

"device_abc123"

Body

application/json

The action to perform on the EV Charger device

Begin a charging session on the connected vehicle.

​
action
string
required

Action type — start charging the connected vehicle.

Allowed value: "start_charging"
​
sandbox
object

Optional sandbox configuration for testing.

Response

Action acknowledged and queued for processing

​
actionId
string
required

Unique identifier for the action.

​
state
enum<string>
required

Current state of the action.

Available options:
acknowledged,
completed,
failed
​
type
enum<string>
required

Type of action being performed.

Available options:
ev-charger:start_charging,
ev-charger:stop_charging,
ev-charger:set_max_power
​
createdAt
string<date-time>
required

Timestamp when the action was created.