API Reference - Amps AI Documentation

Endpoints are grouped by device type. Each type has a list route and a read route. Battery, EV charger, and HVAC add a push route. Battery and EV charger add a settings route, and EV chargers list charging sessions.

Base URL

https://api.amps.ai

Sandbox and live share this host. Your API key selects the environment.

Authentication

Send your API key in the x-api-key header. See Authentication.

curl https://api.amps.ai/battery \
  -H "x-api-key: $AMPS_API_KEY"

Responses

Successful responses wrap the result in data. Errors return error.code, error.message, and optional error.details. See Error handling.

{
  "success": true,
  "data": { "id": "device_abc123" },
  "meta": { "requestId": "req_8a2Bf3kP", "timestamp": "2026-06-01T10:30:00.000Z", "environment": "sandbox" }
}

Next steps

Quickstart

Make your first calls in sandbox.

Error codes

Every code, its status, and what triggers it.