NetCloud Manager API

Build on the network that runs your operations

Programmatic control of your Cradlepoint NetCloud Manager fleet — routers, subscriptions, private cellular, and real-time events. REST APIs, webhooks, and an LLM-ready reference.

Quickstart

From zero to API call in 3 steps

No external code required. Everything you need is right here.

1

Get Your API Credentials

Log into NetCloud Manager, navigate to Tools → NetCloud API, and generate your API keys.

v3 (Recommended): You'll get a Bearer token.
v2 (Legacy): You'll get CP API-ID/key and ECM API-ID/key pairs.
2

Make Your First Request

# List your subscriptions using API v3
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.cradlepointecm.com/api/v3/subscriptions/"
import requests

resp = requests.get(
    "https://api.cradlepointecm.com/api/v3/subscriptions/",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
print(resp.json())
const resp = await fetch("https://api.cradlepointecm.com/api/v3/subscriptions/", {
  headers: { Authorization: "Bearer YOUR_TOKEN" },
});
const data = await resp.json();
3

See the Response

{
  "data": [
    {
      "id": "112345",
      "name": "NetCloud Branch Essentials",
      "start_time": "2026-01-15T00:00:00Z",
      "end_time": "2027-01-15T00:00:00Z",
      "quantity": 25,
      "feature_list_id": "nc-branch-essentials"
    }
  ],
  "links": { "next": "/api/v3/subscriptions/?page[after]=abc123" }
}

That's it. You're in. Now explore the full API below.

Webhooks

Real-time events. No polling.

Subscribe to network events and react instantly when things change.

Read the full Webhooks guide →
// Device state change
{
  "event": "router.state_change",
  "timestamp": "2026-04-11T14:30:00Z",
  "data": {
    "router_id": "112345",
    "name": "Store-42-Primary",
    "previous_state": "online",
    "current_state": "offline",
    "group": "Retail-West",
    "last_seen": "2026-04-11T14:29:47Z"
  }
}
// Configuration change
{
  "event": "router.config_push",
  "timestamp": "2026-04-11T14:31:12Z",
  "data": {
    "router_id": "112345",
    "name": "Store-42-Primary",
    "change": "config_push",
    "status": "applied",
    "actor": "[email protected]"
  }
}
// Alert triggered
{
  "event": "alert.triggered",
  "timestamp": "2026-04-11T14:32:05Z",
  "data": {
    "router_id": "112345",
    "alert_type": "signal_strength_alert",
    "threshold": -90,
    "value": -97,
    "severity": "warning"
  }
}
// Firmware update
{
  "event": "router.firmware_update",
  "timestamp": "2026-04-11T14:35:40Z",
  "data": {
    "router_id": "112345",
    "from_version": "7.22.12",
    "to_version": "7.23.10",
    "status": "in_progress",
    "progress": 0.62
  }
}
Use Cases

What will you build?

From monitoring dashboards to AI-powered network automation.

Custom NOC Dashboard

Build a network operations center tailored to your fleet with real-time status, signal quality, and alerting.

Automated Provisioning

Zero-touch deployment. Automatically configure new routers as they come online based on group policies.

ITSM Integration

Connect NCM to ServiceNow, PagerDuty, or Splunk. Auto-create tickets when devices go offline.

AI Network Agent

Let AI assistants query fleet health, diagnose issues, and recommend optimizations using natural language.

MSP Portal

Build a white-label management portal for your customers with multi-tenant fleet visibility.

CI/CD for Networks

Version control your network configs. Push changes through staging to production like code deployments.

Authentication

Secure by default

TLS 1.2+, scoped tokens, and rate limiting on every request.

v3 Bearer Token

Recommended for all new integrations. Single token, simple header.

Authorization: Bearer <your_token>

v2 API Key Pairs

Legacy authentication using two key pairs in custom headers.

X-CP-API-ID: <cp_api_id>
X-CP-API-KEY: <cp_api_key>
X-ECM-API-ID: <ecm_api_id>
X-ECM-API-KEY: <ecm_api_key>
Content-Type: application/json

Rate Limiting

All API requests are rate limited to maintain platform health. Check response headers for your current limits.

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1a0234da79