---
title: "List devices in the project"
method: GET
path: "/v1/projects/{projectId}/devices"
tags: ["Devices"]
---

# List devices in the project

`GET /v1/projects/{projectId}/devices`

List devices in the project, optionally applying filters and pagination parameters.

Devices can be filtered by any property, and additionally filtered by a freetext search term.

## Path parameters

- `projectId` string, required

## Query parameters

- `page` integer
- `perPage` integer
- `deviceName` string
- `hardwareId` string
- `tags` string[]
- `blueprintId` string
- `statePath` string
- `streamPath` string
- `updatePath` string
- `term` string
- `enabled` boolean
- `cohortId` string

## Response `200`

A successful response.

- GoliothListDeviceResponse
  - `list` GoliothDevice[]
    - `blueprintId` string
    - `certificateId` string
    - `cohortId` string
    - `createdAt` string, date-time
    - `data` object
    - `enabled` boolean
    - `hardwareIds` string[]
    - `id` string
    - `lastReport` string, date-time
    - `metadata` GoliothDeviceMetadata
      - `lastReport` string, date-time
      - `lastSeenOffline` string, date-time
      - `lastSeenOnline` string, date-time
      - `lastSettingsStatus` GoliothSettingsStatus
        - `errors` GoliothSettingError[]
          - `code` integer
          - `codeDescription` string
          - `deviceDetails` string
          - `key` string
        - `reportedVersion` string
        - `status` string
        - `statusDetail` string
        - `syncTime` string, date-time
      - `status` string
      - `update` object — Latest Firmware Update information.
    - `name` string
    - `status` string
    - `tagIds` string[]
    - `updatedAt` string, date-time
  - `page` integer
  - `perPage` integer
  - `total` integer

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/golioth/apis/golioth-api.md) · [All operations](https://skmtc.dev/golioth/apis/golioth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/golioth/golioth-api/revisions/47c98ae69a55/schema)