Device Management APIs Overview

The Device Management APIs enable you to retrieve comprehensive information about devices across your N-central environment. Through these endpoints, you can access device details, monitor service status, and track asset information.

Understanding Devices in N-central

N-central monitors and manages three main device types:

Network Devices

Workstations and laptops
Servers
Routers and switches
Printers and scanners
Storage devices

Mobile Devices

Smartphones
Tablets

Cloud Service Devices

Office 365 resources
Other SaaS offerings

API Methods

The Device Management API provides endpoints for retrieving device information, monitoring status, and managing device properties. For detailed information about using these endpoints, see our Retrieving Device Details guide.

Available Endpoints

Core Device Operations

GET /api/devices - Retrieves a paginated list of all managed devices in your N-central environment.
GET /api/devices/{deviceId} - Retrieves detailed information about a specific device.
GET /api/devices/{deviceId}/assets - Retrieves hardware and software inventory details for a device.
GET /api/devices/{deviceId}/assets/lifecycle-info - Retrieves warranty, lease, and lifecycle information for a device.

Device Monitoring

GET /api/devices/{deviceId}/service-monitor-status - Retrieves current service monitoring status and health information.
GET /api/devices/{deviceId}/scheduled-tasks - Retrieves a list of scheduled tasks associated with a device.
GET /api/devices/{deviceId}/maintenance-windows - Retrieves maintenance window schedules for a device.

Device Properties

GET /api/devices/{deviceId}/custom-properties - Retrieves custom fields and attributes configured for a device.

Key Features

Comprehensive Device Information

Access detailed device information including hardware specifications, network configuration, and installed software. This data helps you maintain accurate asset records and track your device inventory.

Status Monitoring

View device health and service status through service monitoring endpoints. Track task execution and maintain visibility into service quality across your managed devices.

Lifecycle Tracking

Access device lifecycle information including warranty, lease, and replacement dates. This data helps you plan hardware refreshes and maintain accurate asset records.

Custom Property Support

View and manage custom properties to track organization-specific device attributes.