---
title: "Get a phone's live screen preview"
method: GET
path: "/phones/{phone_id}/preview"
tags: ["phones"]
---

# Get a phone's live screen preview

`GET /phones/{phone_id}/preview`

Returns a short-lived URL for the phone's current screen preview — a rolling JPEG refreshed every few seconds while the phone is paired, available with or without an active session. Poll this endpoint and swap the image; every call mints a fresh URL. Status is "pending" when no preview exists yet. Authorized to the org that owns the phone or currently holds its active session; any other org reads as not found.

## Path parameters

- `phone_id` string, required — Phone identifier

## Response `200`

OK

- PhonePreviewResponse — Phone preview lookup result.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `status` 'ready' | 'pending', required — 'ready' when a preview URL is returned, or 'pending' when no preview exists.
  - `url` string — URL for the current preview JPEG, set only when status is 'ready'. Time-limited; poll for a fresh image.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/versions/108ab4b41051/schema)