---
title: "List available devices"
method: GET
path: "/api/devices"
tags: ["Devices"]
---

# List available devices

`GET /api/devices`

## Request

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

Returns mobile devices available for testing from AWS Device Farm.
Filter by platform or availability. Use a device's `arn` when creating
mobile sessions via `POST /api/sessions`.

## Query parameters

- `platform` 'ANDROID' | 'IOS'
- `availableOnly` boolean

## Response `200`

List of devices.

- object
  - `devices` Device[], required
    - `arn` string: Encrypted device identifier token. Pass this value as `deviceArn` when creating sessions.
    - `name` string
    - `manufacturer` string
    - `model` string
    - `modelId` string
    - `platform` 'ANDROID' | 'IOS'
    - `os` string
    - `formFactor` 'PHONE' | 'TABLET'
    - `availability` string
    - `heapSize` integer, nullable
    - `memory` integer, nullable
    - `resolution` object, nullable
      - `width` integer
      - `height` integer

## Other responses

- `400`: `platform` is not ANDROID or IOS.
- `401`: Missing or invalid API key.
- `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)