Read Charging Sessions

curl -X GET "https://api.amps.ai/ev-charger/device_abc123/sessions?limit=2" \
  -H "x-api-key: sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "evs_Ht6vB1zQnE5wXpKm7ArJdU",
        "deviceId": "device_abc123",
        "status": "active",
        "startedAt": "2026-07-29T22:48:00.000Z",
        "energyDelivered": { "value": 12.3, "unit": "kwh" },
        "measurement": "metered",
        "links": { "device": "/ev-charger/device_abc123" }
      },
      {
        "id": "evs_9tQ2mK4xPvR8sLdN3bWfYc",
        "deviceId": "device_abc123",
        "status": "completed",
        "startedAt": "2026-07-28T22:31:00.000Z",
        "endedAt": "2026-07-29T04:12:00.000Z",
        "energyDelivered": { "value": 41.6, "unit": "kwh" },
        "measurement": "metered",
        "endReason": "vehicle_finished",
        "links": { "device": "/ev-charger/device_abc123" }
      }
    ],
    "pagination": { "limit": 2, "offset": 0, "total": 3, "hasMore": true },
    "window": {
      "from": "2026-06-30T09:15:00.000Z",
      "to": "2026-07-30T09:15:00.000Z"
    }
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-07-30T09:15:00.000Z",
    "latencyMs": 12
  }
}

const { items } = (await res.json()).data;

for (const s of items) {
  if (s.status === "active") {
    console.log(`charging since ${s.startedAt}`);
  } else {
    console.log(`${s.energyDelivered.value} kWh, ended ${s.endReason}`);
  }
}

async function allSessions(deviceId) {
  const out = [];
  let offset = 0;
  let to = null;

  for (;;) {
    const url = new URL(`https://api.amps.ai/ev-charger/${deviceId}/sessions`);
    url.searchParams.set("limit", "50");
    url.searchParams.set("offset", String(offset));
    if (to) url.searchParams.set("to", to);

    const res = await fetch(url, {
      headers: { "x-api-key": process.env.AMPS_API_KEY },
    });
    const { data } = await res.json();
    to ??= data.window.to;
    out.push(...data.items);
    if (!data.pagination.hasMore) return out;
    offset += data.pagination.limit;
  }
}