---
title: "List digital devices"
method: GET
path: "/api/v2/devices"
tags: ["Devices"]
---

# List digital devices

`GET /api/v2/devices`

## Request

- Base URL: `https://api.kiloiot.io`
- URL: `https://api.kiloiot.io/api/v2/devices`
- Auth: API key in header `X-API-Key` and API key in header `X-Organization-Id`

Retrieve all digital devices for the organization.

**Required scope:** `devices:read`

## Query parameters

- `organizationId` string, required
- `limit` integer
- `offset` integer
- `search` string

## Response `200`

OK

- object
  - `devices` object[]
    - `id` string
    - `name` string
    - `organizationId` string
    - `lastSeen` string
    - `physicalDevice` object
      - `id` string
      - `clientDeviceId` string
      - `connectionId` string
    - `sensors` object[]
      - `id` string
      - `sensorTemplateId` string
    - `createdAt` string
    - `updatedAt` string
  - `total` integer

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions (missing required scope)

---

[API](https://skmtc.dev/kiloiot/apis/kiloiot-public-api.md) · [All operations](https://skmtc.dev/kiloiot/apis/kiloiot-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kiloiot/apis/kiloiot-public-api/revisions/faf39bde186c?raw)