---
title: "List registered local devices"
method: GET
path: "/api/devices/user"
tags: ["Devices"]
---

# List registered local devices

`GET /api/devices/user`

## Request

- Base URL: `https://aximo.autify.com`
- URL: `https://aximo.autify.com/api/devices/user`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/autify/apis/aximo-api/docs/api/devices/user/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns local devices (BYOD) registered by the authenticated user (the
API key's owner) only. To discover devices registered by any member of
your organization, use `GET /api/organizations/devices`.
Use a device's `id` as `userDeviceId` when creating sessions or
triggering runs.

## Response `200`

List of registered devices.

- object
  - `devices` UserDevice[], required
    - `id` string, uuid, required: Pass this value as `userDeviceId` when creating sessions or triggering runs.
    - `name` string, required
    - `platform` 'windows' | 'macos' | 'linux' | 'ios' | 'android', required
    - `os` string, nullable: OS version string reported at registration.
    - `status` 'online' | 'offline', required: Last known connection status of the device agent.
    - `lastSeenAt` string, date-time, nullable
    - `createdAt` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: API key is not scoped to an organization, the user is banned, or the user is no longer a member of the organization.
- `404`: BYOD is not enabled for the organization.
- `429`: Rate limit exceeded — e.g. the daily session limit was reached for the organization, or too many API requests were sent in a short window (retry after the number of seconds in the `Retry-After` header).
- `500`: Unexpected server error.

---

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