# private cellular radio metrics — NCM API

Beta. Throughput samples for each radio in a private cellular network: timestamped bits uploaded and downloaded, per radio. Read-only, a single list call. Records reference the radio they came from; private cellular radio statuses carries live state rather than history.

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

## Authentication

This is a v3 endpoint (`/api/v3/` path). Send a Bearer token on every request:

```http
Authorization: Bearer <token>
```

Tokens are generated in the NCM UI under API Keys. The v2 and v3 auth schemes are NOT interchangeable: v2 API-key headers are rejected on v3 endpoints.

### GET /api/v3/beta/private_cellular_radio_metrics

List PCN Radio Metrics

Return a list of private cellular AP information

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| page[after] | query | string | no |  |
| page[before] | query | string | no |  |
| page[size] | query | integer | no |  |
| interval | query | array of string (hour | day) | yes | The hourly or daily data to return the results. |
| fields | query | array of string | no | Provide bits_downloaded, bits_uploaded, connection_requests, successful_connection_requests, failed_connection_requests, ho_successful, ho_failed, ho_requests, sas_register_success, sas_register_failed, sas_register_requests, sas_grant_success, sas_grant_failed, sas_grant_requests, cause_code, provisioned_cause_code here to get it's value in the results. |
| filter[start_time] | query | string | no | The start time from which to return the results ie; 2023-07-14T10:16:19.000Z. |
| filter[end_time] | query | string | no | The end time from which to return the results ie; 2023-07-14T10:16:19.000Z. |
| filter[cell] | query | string | no | The cell from which to return the results. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/private_cellular_radio_metrics" \
  -H "Authorization: Bearer <token>"
```

**Response 200** — successful operation