---
title: "List devices, newest first"
method: GET
path: "/v1/edge/devices"
tags: ["Edge Devices"]
---

# List devices, newest first

`GET /v1/edge/devices`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/edge/devices`
- Auth: API key in header `X-User-Token`

## Query parameters

- `mac_address` string
- `mender_device_id` string
- `facility_id` integer
- `upload_mode` 'continuous' | 'on_demand'
- `status` 'pending' | 'accepted' | 'rejected' | 'preauthorized' | 'noauth' | 'decommissioned'
- `unmapped` boolean
- `page` integer
- `per_page` integer

## Response `200`

List of devices

- Device[]
  - `id` integer
  - `mender_device_id` string, nullable
  - `mac_address` string, nullable
  - `status` 'pending' | 'accepted' | 'rejected' | 'preauthorized' | 'noauth' | 'decommissioned'
  - `facility_id` integer, nullable
  - `mender_attributes` object
  - `upload_mode` 'continuous' | 'on_demand'
  - `preview_generation_enabled` boolean
  - `archive_disk` boolean
  - `decommissioned_at` string, date-time, nullable
  - `arenas` object[]
  - `facility` object, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-11-05** `b5920403538d`: 2 breaking, 1 warning, 3 info
  - the response property `items/mac_address` became nullable for the status `200`
  - the response property `items/mender_device_id` became nullable for the status `200`
  - added the new `decommissioned` enum value to the `items/status` response property for the response status `200`
  - added the new optional `query` request parameter `status`
  - …2 more

[Operation history](https://skmtc.dev/hify/apis/hify-apis/changes/v1/edge/devices/get.md)

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)