Push EV Charger action

POST

ev-charger

{deviceId}

curl

curl --request POST \
  --url 'https://api.amps.ai/ev-charger/device_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "action": {
      "command": "charge"
    }
  }'

const response = await fetch('https://api.amps.ai/ev-charger/device_abc123', {
  method: 'POST',
  headers: {
    'x-api-key': 'amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    "action": {
      "command": "charge"
    }
  }),
});

const data = await response.json();

import requests

url = 'https://api.amps.ai/ev-charger/device_abc123'
headers = {
    'x-api-key': 'amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx',
    'content-type': 'application/json',
}
payload = {
    "action": {
        "command": "charge",
    },
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.amps.ai/ev-charger/{deviceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => [
        'command' => 'charge'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.amps.ai/ev-charger/{deviceId}"

	payload := strings.NewReader("{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.amps.ai/ev-charger/{deviceId}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.amps.ai/ev-charger/{deviceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "act_2026050712000ev02",
    "deviceId": "dev_ev7a3b1f",
    "deviceType": "ev_charger",
    "command": "charge",
    "parameters": {
      "power": {
        "value": 7.4,
        "unit": "kw"
      }
    },
    "state": "acknowledged",
    "createdAt": "2026-05-07T12:00:00.000Z",
    "start": null,
    "links": {
      "self": "/actions/act_2026050712000ev02"
    }
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-06-02T12:00:00.000Z",
    "latencyMs": 12
  }
}

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

A single EV-charger action plus optional onConflict strategy and sandbox controls.

Action variants describe what the API accepts. Per-device support varies; the commands map on GET /ev-charger/{deviceId} shows which actions a specific device handles.

action

EV Charger Action · object

required

A canonical EV-charger command. charge begins charging (rate-capped by power/current, stopped by energy); idle pauses, holding the session; the auto.* modes hand control to the charger own optimisation and run until replaced. auto.charge_surplus_only charges from on-site surplus alone and stops when it runs out; auto.charge_surplus_first tops up from the grid so charging never stops.

Show child attributes

Examples:

{ "command": "charge" }

{
  "command": "charge",
  "parameters": { "power": { "value": 4.2, "unit": "kw" } },
  "start": "2026-07-30T17:00:00",
  "end": "2026-07-30T19:00:00"
}

{ "command": "auto.charge_tariff" }

{
  "command": "auto.charge_surplus_only",
  "start": "2026-07-31T09:00:00"
}

onConflict

enum<string>

cancel_and_replace cancels the active action before running this one; queue_after defers this one until the active action completes. Omit to receive 409 on conflict.

Available options:

cancel_and_replace,

queue_after

sandbox

Ev Charger Sandbox Config · object

Sandbox controls for testing error paths. Ignored in live environments.

Show child attributes

Response

Action acknowledged and queued for processing

success

boolean

required

Always true for success responses.

data

Ev Charger Push Response · object

required

Result of a push. Mirrors the dispatch (command + parameters + deviceType) and carries links.self to track the action. For immediate actions, state reflects the dispatch outcome. For deferred actions, state is scheduled, start carries the fire time, and end the window close when a window was requested.

Show child attributes

meta

Response Meta · object

required

Metadata attached to every response: the request identifier, the serving environment, the build timestamp, and the server-side latency.

Show child attributes

curl

curl --request POST \
  --url 'https://api.amps.ai/ev-charger/device_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "action": {
      "command": "charge"
    }
  }'

const response = await fetch('https://api.amps.ai/ev-charger/device_abc123', {
  method: 'POST',
  headers: {
    'x-api-key': 'amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    "action": {
      "command": "charge"
    }
  }),
});

const data = await response.json();

import requests

url = 'https://api.amps.ai/ev-charger/device_abc123'
headers = {
    'x-api-key': 'amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx',
    'content-type': 'application/json',
}
payload = {
    "action": {
        "command": "charge",
    },
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.amps.ai/ev-charger/{deviceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => [
        'command' => 'charge'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.amps.ai/ev-charger/{deviceId}"

	payload := strings.NewReader("{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.amps.ai/ev-charger/{deviceId}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.amps.ai/ev-charger/{deviceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": {\n    \"command\": \"charge\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "act_2026050712000ev02",
    "deviceId": "dev_ev7a3b1f",
    "deviceType": "ev_charger",
    "command": "charge",
    "parameters": {
      "power": {
        "value": 7.4,
        "unit": "kw"
      }
    },
    "state": "acknowledged",
    "createdAt": "2026-05-07T12:00:00.000Z",
    "start": null,
    "links": {
      "self": "/actions/act_2026050712000ev02"
    }
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-06-02T12:00:00.000Z",
    "latencyMs": 12
  }
}

Get Started

Concepts

API Reference

Guides

Quick reference

More

Authorizations

Path Parameters

Body

Response