# private cellular core statuses — NCM API

Beta. The current interface state of each private cellular core: interface name, up/down state, and the time the status was last recorded. Read-only, a single list call. Use it as the live health check on a core; private cellular core metrics carries the throughput history instead.

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

### GET /api/v3/beta/private_cellular_core_statuses

List PCN Core statuses

Return a list of private cellular core status 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 |  |
| 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[router] | query | integer | yes | The router from which to return the results. |

**Example request**

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

**Response 200** — successful operation

```json
{
  "data": [
    {
      "type": "private_cellular_core_statuses",
      "id": "044ca49e-2b29-4b03-bc5e-511729653f92",
      "attributes": {
        "interface_name": "lan0",
        "interface_state": "up",
        "updated_at": "2023-04-03T07:34:32.570021Z",
        "status_time": "2023-04-03T07:34:29.914716Z"
      },
      "relationships": {
        "router": {
          "data": {
            "type": "routers",
            "id": "3524047"
          }
        }
      }
    },
    {
      "type": "private_cellular_core_statuses",
      "id": "c3d3ed3c-a9e8-40b0-9db1-c875aa26a1df",
      "attributes": {
        "interface_name": "mgmt0",
        "interface_state": "up",
        "updated_at": "2023-04-03T07:34:32.570021Z",
        "status_time": "2023-04-03T07:34:29.914716Z"
      },
      "relationships": {
        "router": {
          "data": {
            "type": "routers",
            "id": "3524047"
          }
        }
      }
    },
    {
      "type": "private_cellular_core_statuses",
      "id": "90d6cef7-95ec-4f97-ba8a-fa9dd2127094",
      "attributes": {
        "interface_name": "wan0",
        "interface_state": "up",
        "updated_at": "2023-04-03T07:34:32.570021Z",
        "status_time": "2023-04-03T07:34:29.914715Z"
      },
      "relationships": {
        "router": {
          "data": {
            "type": "routers",
            "id": "3524047"
          }
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "before": "<cursor_key_before>",
      "after": "<cursor_key_after>",
      "limit": 10
    }
  },
  "links": {
    "next": "https://api.cradlepointecm.com/api/v3/beta/private_cellular_core_status?page[after]=<after_cursor_key>&page[limit]=10",
    "prev": "https://api.cradlepointecm.com/api/v3/beta/private_cellular_core_status?page[before]=<before_cursor_key>&page[limit]=10"
  }
}
```