---
title: "ListDevices"
method: GET
path: "/devices"
tags: ["All Devices"]
---

# ListDevices

`GET /devices`

Fetch a list of devices associated with the team defined by your API key.

## Query parameters

- `includeState` boolean
- `includeStateMeta` boolean
- `transform` string[]
- `pageLimit` integer — Maximum number of items you want returned in the response (<=100).
- `tags` DeviceTag[]
- `deviceIds` DeviceId[]
- `firmwareSupport` FirmwareTypes[]
- `firmwareSupportExclude` FirmwareTypes[]
- `subTypes` ThingType[]
- `deviceNameFuzzy` string
- `pageNextToken` string — If available in the initial response, use this token to retrieve the next page of items in the list. When supplying as a request parameter, use URL-encoding.

## Response `200`

Ok

- PaginatedResultDeviceOrJSONataTransformedResponse
  - `items` union[], required
    - union
      - Device
        - `id` string, required — This is the canonical device id used in the device certificate, and as the MQTT client id.
        - `name` string, required — Friendly device name. Can be used for searching and filtering devices.
        - `image` string
        - `tags` DeviceTag[], required
        - `tenantId` string, required — The UUID of the team owning the device(s)
        - `subType` union, required
          - 'jitp-generic' | 'jitp-nordic-hardware' | 'unknown'
          - string
        - `firmware` DeviceFirmwareArgs
          - `supports` string[]
          - `app` object
            - `version` string
            - `name` string
          - `boot` string
          - `modem` string
          - `smpDeviceAppVer` string
        - `$meta` DeviceDocMeta, required
          - `createdAt` string, date-time
          - `updatedAt` string, date-time
        - `type` 'Generic', required
        - `state` GenericDeviceState
          - `reported` object
          - `desired` object
          - `delta` object
          - `metadata` object
          - `version` number, double
      - unknown
  - `total` integer — Reflects the total results returned by the query, which may be less than the total number of items available. If the response contains a `pageNextToken` value, you can supply the `pageNextToken` in the next request to get more results. The maximum value of `total` is the page limit of the request, or ten pages if no page limit is provided.
  - `pageNextToken` string — Token used to retrieve the next page of items in the list. Present in a response only if the total available results exceeds the specified limit on a page. This token does not change between requests. When supplying as a request parameter, use URL-encoding.

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)