---
title: "Get the list of devices"
method: GET
path: "/api/v2/ndm/devices"
tags: ["Network Device Monitoring"]
---

# Get the list of devices

`GET /api/v2/ndm/devices`

Get the list of devices.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `sort` string
- `filter[tag]` string

## Response `200`

OK

- ListDevicesResponse — List devices response.
  - `data` DevicesListData[] — The list devices response data.
    - `attributes` DeviceAttributes — The device attributes
      - `description` string — The device description
      - `device_type` string — The device type
      - `integration` string — The device integration
      - `interface_statuses` DeviceAttributesInterfaceStatuses — Count of the device interfaces by status
        - `down` integer — The number of interfaces that are down
        - `off` integer — The number of interfaces that are off
        - `up` integer — The number of interfaces that are up
        - `warning` integer — The number of interfaces that are in a warning state
      - `ip_address` string — The device IP address
      - `location` string — The device location
      - `model` string — The device model
      - `name` string — The device name
      - `os_hostname` string — The device OS hostname
      - `os_name` string — The device OS name
      - `os_version` string — The device OS version
      - `ping_status` string — The device ping status
      - `product_name` string — The device product name
      - `serial_number` string — The device serial number
      - `status` string — The device SNMP status
      - `subnet` string — The device subnet
      - `sys_object_id` string — The device `sys_object_id`
      - `tags` string[] — The list of device tags
      - `vendor` string — The device vendor
      - `version` string — The device version
    - `id` string — The device ID
    - `type` string — The type of the resource. The value should always be device.
  - `meta` ListDevicesResponseMetadata — Object describing meta attributes of response.
    - `page` ListDevicesResponseMetadataPage — Pagination object.
      - `total_filtered_count` integer — Total count of devices matched by the filter.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)