# private cellular radio statuses — NCM API

Beta. Live operational state for private cellular radios: online status, S1 and IPsec state, connected UEs, CBRS SAS status, operating transmit power and IP address. Read and update, covering radio configurations and a separate logs collection you can request and then retrieve. The fullest health view of a PCN radio.

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_statuses/{id}

Get private cellular radio statuses by ID

Get a single private cellular radio status.

> **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 |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

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

**Response 200**

### GET /api/v3/beta/private_cellular_radio_configurations/{id}

Get private cellular radio configurations by ID

Get a single private cellular radio configuration.

> **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 |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

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

**Response 200**

### PUT /api/v3/beta/private_cellular_radio_configurations/{id}

Update private cellular radio configurations by ID

Updates a single private cellular radio configuration.

> **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 |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Request body**

**Example request**

```bash
curl -X PUT "https://api.cradlepointecm.com/api/v3/beta/private_cellular_radio_configurations/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/v3/beta/private_cellular_radios/logs

Get logs

Return a list of private cellular radio logs.

> **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 |  |
| filter[cell_id] | query | string | yes |  |

**Example request**

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

**Response 200**

**Response 403** — Access Denied

**Response 409** — Conflict Error

**Response 500** — Internal Server Error

### POST /api/v3/beta/private_cellular_radios/logs

Create logs

Create private cellular radio logs object.

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

**Request body**

**Example request**

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

**Response 202**

**Response 403** — Access Denied

**Response 409** — Conflict Error

**Response 500** — Internal Server Error

### GET /api/v3/beta/private_cellular_radios/logs/{id}

Get logs by ID

Get a single private cellular radio log.

> **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 |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/private_cellular_radios/logs/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

**Response 403** — Access Denied

**Response 409** — Conflict Error

**Response 500** — Internal Server Error

### GET /api/v3/beta/private_cellular_radio_statuses

List private cellular radio statuses

Get the status of every private cellular radio: online status, S1, IPsec and Ethernet state, connected UEs, CBRS SAS status and operating transmit power. Each record has the same fields as the single-record GET.

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

**Example request**

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

**Response 200**