# net device signal samples — NCM API

Periodic snapshots of modem signal strength per network interface, the raw material behind signal-quality reporting. Read-only, a single list call, filtered by device and time range. Sample rate means volume, so filter tightly; net device metrics carries the latest values instead.

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

### GET /net_device_signal_samples/

Get information about net_device_signal_samples

<p>Use the GET method on this endpoint to retrieve net_device_signal_samples records. Use the available filtering fields to narrow or broaden your search.</p><p><strong>Note: </strong>There is a 100 device limit for API queries. If you attempt to retrieve records for more than 100 devices in a single query you will receive an error message. If you do not explicitly specify devices, it is assumed that you are trying to pull records for all devices in your account. If you have more than 100 devices in your account then you may query in batches. See the example titled 'Net Device Usage and Signal Samples' on the Sample Code page for details on querying net_device_signal_samples in batches.</p>

| 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 Id</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> |
| net_device | query | in: int<br />out: url | no | ID of a net device |
| net_device__in | query | in: int<br />out: url | no | Filter for net_device contains - a comma-separated list of net_device IDs |
| created_at | query | timestamp | no | Timestamp for when the net_device_signal_samples record was created |
| created_at__lt | query | timestamp | no | Filter for created_at is less than |
| created_at__gt | query | timestamp | no | Filter for created_at is greater than |
| created_at_timeuuid | query | timeuuid | no | A unique ID (timeuuid) associated with the created_at timestamp |
| created_at_timeuuid__in | query | timeuuid | no | Filter for created_at_timeuuid in - a comma-separated list of timeuuids for net_device_signal_samples records |
| created_at_timeuuid__gt | query | timeuuid | no | Filter for created_at_timeuuid is greater than |
| created_at_timeuuid__gte | query | timeuuid | no | Filter for created_at_timeuuid is greater than or equal to |
| created_at_timeuuid__lt | query | timeuuid | no | Filter for created_at_timeuuid is less than |
| created_at_timeuuid__lte | query | timeuuid | no | Filter for created_at_timeuuid is less than or equal |
| order_by | query | string | no | Specifies the sort order of response data |
| limit | query | integer | no | Restricts the number of records returned in a recordset to this value. Max value is 500. |

**Example request**

```bash
curl "https://www.cradlepointecm.com/api/v2/net_device_signal_samples/" \
  -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": [
    {
      "cinr": null,
      "created_at": "2021-04-28T08:35:09.785076+00:00",
      "created_at_timeuuid": "a477e788-a7fc-11eb-bec0-925dfd668908",
      "dbm": -69,
      "ecio": null,
      "net_device": "https://www.cradlepointecm.com/api/v2/net_devices/73308086/",
      "rsrp": -96,
      "rsrp5g": null,
      "rsrp5g_highband": null,
      "rsrq": -10,
      "rsrq5g": null,
      "rsrq5g_highband": null,
      "rssi": null,
      "rssnr": null,
      "signal_percent": 100,
      "sinr": 16.4,
      "sinr5g": null,
      "sinr5g_highband": null,
      "uptime": 138686
    },
    {}
  ],
  "meta": {
    "limit": 20,
    "next": "https://www.cradlepointecm.com/api/v2/net_device_signal_samples/?created_at_timeuuid__lt=e8f813de-a7e2-11eb-bc01-067ecc6c90d9"
  }
}
```