# 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

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

private_cellular_radio_statuses_retrieve

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}

private_cellular_radio_configurations_retrieve

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}

private_cellular_radio_configurations_update

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

private_cellular_radios_list

Return a list of private cellular radios.

> **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 |  |
| sort | query | array of string (-name | name) | no | Which field to use when ordering the results. |

**Example request**

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

**Response 200**

```json
{
  "data": {
    "type": "private_cellular_radio_statuses",
    "id": "01GZDYERMREKE42562B8NAY5MV",
    "attributes": {
      "admin_state": "disabled",
      "ipv4_address": null,
      "last_update_time": "2023-05-02T09:59:49",
      "online_status": "disabled",
      "s1_status": "disconnected",
      "time_synchronization": "out_of_sync",
      "ethernet_status": "down",
      "operational_status": "down",
      "ipsec_status": "disconnected",
      "connected_ues": 0,
      "boot_time": 0,
      "cbrs_sas_status": null,
      "operating_tx_power": 0
    },
    "relationships": {
      "cell": {
        "data": {
          "type": "private_cellular_radios",
          "id": "01GZDYERMREKE42562B8NAY5MV"
        }
      }
    }
  }
}
```

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

private_cellular_radios_retrieve

Get a single private cellular radio.

> **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/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

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

private_cellular_radios_update

Update a single private cellular radio.

> **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_radios/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

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

private_cellular_radios_logs_list

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

private_cellular_radios_logs_create

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}

private_cellular_radio_logs_retrieve

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