---
title: "Get a session's live thumbnail"
method: GET
path: "/phones/sessions/{session_id}/thumbnail"
tags: ["Phones"]
---

# Get a session's live thumbnail

`GET /phones/sessions/{session_id}/thumbnail`

Returns a short-lived URL for the session's current screen thumbnail — a rolling JPEG refreshed every few seconds while the session is active. Poll this endpoint and swap the image; every call mints a fresh URL. Status is "pending" (no URL) before the first frame lands or after the session ends. Org-scoped: another org's session reads as not found.

## Path parameters

- `session_id` string, uuid, required — Phone session identifier

## Response `200`

OK

- PhoneSessionThumbnailResponse — Session thumbnail lookup result.
  - `status` 'ready' | 'pending', required — 'ready' when a thumbnail URL is returned, or 'pending' when no thumbnail exists.
  - `url` string — URL for the current thumbnail JPEG, set only when status is 'ready'. The URL is time-limited; poll the endpoint for a fresh image.

## Other responses

- `default` — Error

## Changes

- **2026-08-17** `261c340a3f6d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/phones/sessions/:session_id/thumbnail/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/261c340a3f6d/schema)