---
title: "A fresh look at the phone - screenshot, UI tree and the app on screen in one call"
method: GET
path: "/devices/{name}/observe"
tags: ["AI agents"]
---

# A fresh look at the phone - screenshot, UI tree and the app on screen in one call

`GET /devices/{name}/observe`

## Request

- Base URL: `https://api.clousd.com/v1`
- URL: `https://api.clousd.com/v1/devices/{name}/observe`
- Auth: HTTP bearer

## Query parameters

- `w` integer
- `ui` 0 | 1

## Response `200`

OK

- Observation
  - `seq` integer
  - `ts` string, date-time
  - `ms` integer: time the observation took
  - `screen` object
    - `w` integer
    - `h` integer
  - `image` object
    - `w` integer
    - `h` integer
    - `format` string
    - `data` string, byte
  - `package` string
  - `activity` string
  - `ui` UINode[]
    - `text` string
    - `desc` string
    - `id` string
    - `class` string
    - `pkg` string
    - `b` integer[]: x1, y1, x2, y2 in phone pixels
    - `click` boolean
    - `long` boolean
    - `scroll` boolean
    - `focus` boolean
    - `focused` boolean
    - `checked` boolean
    - `disabled` boolean
    - `password` boolean
    - `selected` boolean
  - `ui_error` string: set when the UI tree is not available yet (prefix not_ready)

## Other responses

- `409`: Error

---

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