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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/ndm/devices`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)