---
title: "Get a snapshot"
method: GET
path: "/sessions/{sid}/frame.png"
tags: ["Phone"]
---

# Get a snapshot

`GET /sessions/{sid}/frame.png`

## Request

- Base URL: `https://api.phone-harness.com`
- URL: `https://api.phone-harness.com/sessions/{sid}/frame.png`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Read a coalesced still image from a ready session. Captures are attempted at most once every two seconds; a cached image may be returned while an operation runs. This is not a live video endpoint and does not extend the session. Inspect Content-Type.

## Path parameters

- `sid` string, required

## Response `200`

PNG on the current Android service; compatible providers may return JPEG.

## Other responses

- `401`: Bad or missing bearer credential.
- `403`: Account access denied or rental access unavailable.
- `404`: No live session visible to the caller.
- `409`: Session is not ready, is closing, or the requested action conflicts with current state.
- `500`: Unexpected service error.
- `503`: No frame available yet.

---

[API](https://skmtc.dev/phone-harness/apis/phone-harness-api.md) - [All operations](https://skmtc.dev/phone-harness/apis/phone-harness-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phone-harness/apis/phone-harness-api/revisions/5af8941102e5?raw)