# batteries — NCM API

Battery information for E100 series devices, reported per device. Read-only, a single list call. Use it to spot units running on battery or approaching end of charge; the device record itself lives under routers.

Base URL: https://www.cradlepointecm.com/api/v2

### GET /batteries/

Get information about batteries

Use the GET method on this endpoint to retrieve batteries records.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| X-ECM-API-ID | header | string | yes | <strong>ECM API app Id</strong> |
| X-ECM-API-KEY | header | string | yes | <strong>ECM API app key</strong> |
| X-CP-API-ID | header | string | yes | <strong>Cradlepoint API app Id</strong> |
| X-CP-API-KEY | header | string | yes | <strong>Cradlepoint API access key</strong> |
| router | query | integer | yes | ID of E100-series router to query for battery information |
| limit | query | integer | no | Restricts the number of records returned in a recordset to this value. Max value is 500. |
| offset | query | integer | no | Specifies where (an index) in a recordset to begin returning records. |

**Example request**

```bash
curl "https://www.cradlepointecm.com/api/v2/batteries/" \
  -H "X-CP-API-ID: <cp-api-id>" \
  -H "X-CP-API-KEY: <cp-api-key>" \
  -H "X-ECM-API-ID: <ecm-api-id>" \
  -H "X-ECM-API-KEY: <ecm-api-key>"
```

**Response 200** — Example response.

```json
{
  "data": [
    {
      "created_at": "2021-01-12T13:48:45.438933+00:00",
      "health": 96,
      "id": "2022",
      "manufacturer": "GETAC",
      "milliamps": 0,
      "millivolts": 8162,
      "resource_url": "https://www.cradlepointecm.com/api/v2/batteries/2022/",
      "router": "https://www.cradlepointecm.com/api/v2/routers/2287406/",
      "rsoc": 100,
      "serial": "GA2039BA001264",
      "status": "Idle",
      "temp": 34,
      "time_remaining": null,
      "type": "battery",
      "updated_at": "2021-03-30T01:38:46.564399+00:00"
    },
    {}
  ]
}
```