← Back to API index
GET /device/list

List available device emulations

Options

Options are grouped for easier scanning, similar to parameter-focused docs.

App

key

query string Optional

API key (optional if using JWT bearer token)

API key used for authentication. Use either the `key` query parameter or `X-API-KEY` header.

Responses

200

Device list

▾ 
{
  "success": true,
  "data": [
    {
      "device_name": "iphone_15_pro",
      "name": "iPhone 15 Pro",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)",
      "screen_width": 393,
      "screen_height": 852,
      "device_scale": 3,
      "device_mobile": true,
      "device_touch": true,
      "device_landscape": false
    },
    {
      "device_name": "iphone_15_pro_landscape",
      "name": "iPhone 15 Pro Landscape",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)",
      "screen_width": 852,
      "screen_height": 393,
      "device_scale": 3,
      "device_mobile": true,
      "device_touch": true,
      "device_landscape": true
    }
  ]
}
401

Unauthorized

▾ 
{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}
403

Forbidden

▾ 
{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}
500

Server error

▾ 
{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}