---
title: "List local devices in your organization"
method: GET
path: "/api/organizations/devices"
tags: ["Devices"]
---

# List local devices in your organization

`GET /api/organizations/devices`

## Request

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

Returns every local device (BYOD) registered in your organization,
regardless of which member registered it, sorted by registration date.
Use this to resolve a device by name when the device may belong to
another member; `GET /api/devices/user` returns only the API key
owner's devices.

Device names are not guaranteed to be unique within an organization.
When more than one device matches a name, use the `id` to disambiguate
rather than picking one arbitrarily.

Offline devices are included, so a missing name and an unavailable
device stay distinguishable. Check `status` before starting a run.

## Response `200`

List of local devices in the organization.

- 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)