Cradlepoint NetCloud Manager API

Cradlepoint NetCloud Manager is a SaaS-type server that enables the remote management of network devices, including routers and access points.

This specification describes the NetCloud Manager API; a RESTful API used by client applications to access the NetCloud service and programmatically perform many of the same functions as can be performed in the NetCloud Manager user interface.

For more information on getting started with the NetCloud Manager API, see the Cradlepoint Connect article NetCloud Manager API Getting Started Guide.

The base URL for the NetCloud Manager API v2 is:
https://www.cradlepointecm.com/api/v2/

The base URL for the NetCloud Manager API v3 is:
https://api.cradlepointecm.com/api/v3/

The NetCloud Manager API v3 Quickstart Guide BETA also contains information on using NetCloud Manager API v3.

What is a REST API?

An API, or application programming interface, is a protocol that enables communication between different software systems. APIs provide the building blocks programmers need to create applications that access the data from a software platform – in this case the data from Cradlepoint NetCloud Manager.

REST, or representational state transfer, is a particular architectural style, common for Web APIs, that leverages existing technologies of the Web (e.g. HTTP, XML) to enable information access on a large scale. The REST architecture was first described by Roy Fielding in his 2000 doctoral dissertation.

A REST API is a hypertext-driven API that uses HTTP methods and follows the REST principles. The Cradlepoint NetCloud Manager REST API uses the following HTTP methods: GET, POST, PUT, PATCH, and DELETE. Note that not all endpoints support all of the REST methods. Some endpoints are read-only and only support the GET method while other endpoints support a mix of all the methods.

Supported TLS Ciphers

In compliance with PCI 3.2, NetCloud Manager API supports TLS v1.2 and 1.3. SSL and earlier versions of TLS are not supported. The following TLS ciphers are supported:

TLS 1.3
          TLS_AES_128_GCM_SHA256
          TLS_AES_256_GCM_SHA384
          TLS_CHACHA20_POLY1305_SHA256
          TLS_AES_128_CCM_SHA256
          TLS_AES_128_CCM_8_SHA256

TLS 1.2

          TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
          TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
          TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
          TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
          TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
          TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
          TLS_RSA_WITH_AES_256_GCM_SHA384
          TLS_RSA_WITH_AES_128_GCM_SHA256
          TLS_RSA_WITH_AES_256_CBC_SHA256
          TLS_RSA_WITH_AES_256_CBC_SHA
          TLS_RSA_WITH_AES_128_CBC_SHA256
          TLS_RSA_WITH_AES_128_CBC_SHA

NetCloud Manager API v2 Endpoint Quick Reference

Category Related Endpoint(s)
Account Information accounts
User Information users
General Router Information routers
Device Locations locations, historical_locations
Log Information activity_logs, router_logs
Device Online/Offline Status router_state_samples
Firmware firmwares, routers
Alerts and Push Alerts alerts, router_alerts, alert_rules, alert_push_destinations, test_alert_push_destinations
Groups Information groups
SDK Apps device_apps, device_app_bindings, device_app_states, device_app_versions
Device Configurations configuration_managers
E100 Battery Information batteries
NetCloud Perimeter Networks router_lans, forwarding_lan_details, overlay_network_bindings
Network Interfaces net_devices, net_device_health, net_device_metrics, net_device_signal_samples, net_device_usage_samples
Failover Information failovers
General Information about Cradlepoint Products products
Reboot a Device via the API reboot_activity
Run a Speed Test on a Router speed_test

NetCloud Manager API v3 Endpoint Quick Reference beta

Category Related Endpoint(s)
Find information about an account's subscriptions subscriptions
Configure and monitor private cellular networks private_cellular_networks, private_cellular_cores, private_cellular_sims, private_cellular_radios, private_cellular_radio_groups, private_cellular_radio_statuses
View, add, modify and delete information about the users in your account users (v3)