NetCloud Manager API

Build on the network that runs your operations

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

Get Started View API Reference

40+
API Endpoints

v2 & v3
API Versions

REST
Architecture

Webhooks
Real-time Events

Make your first API call in 3 steps

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

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.

Make Your First Request

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

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.

Common gotchas:

401 Unauthorized — the auth scheme must match the endpoint version: Bearer tokens work only on /api/v3/ paths, API-key headers only on /api/v2/ paths. Expired or revoked credentials also 401 — regenerate under Tools → NetCloud API.
Pagination — v3 is cursor-based: follow the next-page URL in the response (page[after] cursor) instead of building offsets. v2 uses ?limit=N&offset=M and returns meta.next.
429 Too Many Requests — you hit the rate limit. Wait until the time in the X-RateLimit-Reset response header before retrying.

Two API layers

Device-level control and fleet orchestration. Use v3 for new integrations.

Users

Create, update, and manage user accounts and permissions.

GET /api/v3/users

Subscriptions

View and manage device subscriptions and licensing.

GET /api/v3/subscriptions

Private Cellular

Configure and monitor private cellular networks, cores, SIMs, and radios.

GET /api/v3/private_cellular_networks

Exchange Resources

Create and manage NetCloud Exchange resources and sites.

GET /api/v3/exchange_resources

Exchange Sites

Create and manage NetCloud Exchange site configurations.

GET /api/v3/exchange_sites

View Complete v3 API Reference →

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

v2 vs v3 at a glance

What changes between the layers, at a glance. Note that the version split is by capability, not preference: most fleet and device endpoints — routers, alerts, device health and telemetry — are v2 today, while Private Cellular (5G), eSIM, and NetCloud Exchange are v3. Each endpoint in the API reference states its own version and base URL.

	API v2	API v3
Authentication and authorization	Cradlepoint API Keys and NetCloud Manager API Keys (application identification)	Single Bearer token (user identification)
Documentation specification	Swagger 1.2	OpenAPI 3.0
Pagination	Offset	Cursor
Expandable fields	Yes	No
URL	`https://www.cradlepointecm.com/api/v2/` — include the trailing slash; without it the call redirects and two calls are attributed to your account	`https://api.cradlepointecm.com/api/v3` — no trailing slash on v3 endpoints
Content type	`application/json`	`application/vnd.api+json`

Your language. Your workflow.

Official libraries and tools to accelerate your integration.

Python SDK

The ncm package — full-featured Python client for NCM APIs. Install with: pip install ncm

Postman Collection

Pre-configured requests for every endpoint. Import and start testing.

Script Manager

Web-based tool for bulk operations — configure devices, manage users, update subscriptions.

Sample Scripts

Ready-to-run Python scripts for common tasks — router status, config backup, alert management.

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
  }
}

Webhooks power event-driven automation, AIOps, and live dashboards across your fleet.

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.

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: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1682345678