---
title: "Get devices in organization"
method: GET
path: "/api/v1/organization/devices"
tags: ["Devices"]
---

# Get devices in organization

`GET /api/v1/organization/devices`

Retrieve a paginated list of devices in an organization.

Required permissions, when user-scoped authentication is used: `ORG_DEVICES_VIEW`.

## Query parameters

- `orgId` integer
- `includeSubOrgDevices` boolean
- `page` integer
- `size` integer

## Response `200`

List of devices

- object
  - `content` Device[], required
    - `id` integer, required — Device ID
    - `name` string, required — Device name
    - `templateId` integer, required — Template ID this device belongs to
    - `originalTemplateId` integer, required — Original template ID from the template hierarchy (the root template ID this device is ultimately derived from)
    - `orgId` integer, required — Organization ID this device belongs to
    - `token` string, required — Device authentication token
    - `activatedAt` integer — Device activation timestamp
    - `ownerUserId` integer — Device owner identifier
    - `hardwareInfo` DeviceHardwareInfo
      - `version` string — Device firmware version
      - `fwType` string — Device firmware type
      - `blynkVersion` string — Version of the Blynk Library, that is used on the device
      - `boardType` 'Arduino' | 'BBC_Microbit' | 'ESP32' | 'ESP8266' | 'Lantronix_Fox_3' | 'Microduino' | 'Onion_Omega' | 'Particle' | 'Pycom_WiPy' | 'Raspberry_Pi' | 'Seeed_Wio_Terminal' | 'SparkFun_Blynk_Board' | 'Teensy' | 'TinyDuino' | 'NodeRed' | 'Python' | 'TI_CC3220' | 'Iridium' | 'Iridium_9704_Launch_Pad' | 'NCD' | 'Milesight' | 'Seeed' | 'Blues' | 'MOKOSmart' | 'Thermokon' | 'Miromiko' | 'Pepperl_Fuchs' | 'Atim' | 'Other' — Device board type
      - `build` string — Firmware build number, that is used on the device
      - `templateId` string — The identifier of the template that the device belongs to.
  - `totalElements` integer, required — Total amount of devices, available to fetch.

## Other responses

- `400` — Bad request - requested page size is too big
- `403` — Forbidden
- `404` — Organization not found or access denied
- `429` — Too many requests
- `500` — Internal server error

---

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