---
title: "Device list"
method: GET
path: "/api/devices"
tags: ["Devices"]
---

# Device list

`GET /api/devices`

## Request

- Base URL: `https://dregs.com`
- URL: `https://dregs.com/api/devices`
- Auth: HTTP bearer

List devices tracked by Dregs

## Query parameters

- `request` V1ListDevicesRequest, required
  - `pageNumber` integer
  - `pageSize` integer
  - `order` 'ASC' | 'DESC'
  - `sort` string
  - `search` string
  - `identity` string
  - `term` string
  - `effectiveTerm` string

## Response `200`

Successfully retrieved devices

## Other responses

- `401`: Invalid credentials

---

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