---
title: "GET /v1/printers/{id}/frame"
method: GET
path: "/v1/printers/{id}/frame"
---

# GET /v1/printers/{id}/frame

`GET /v1/printers/{id}/frame`

## Path parameters

- `id` string, required

## Query parameters

- `max_age` number
- `job_id` number
- `subtask_id` string
- `force_fresh` boolean
- `cached_only` boolean

## Response `200`

Default Response

- object
  - `cached` boolean
  - `frame` object, nullable
    - `id` string
    - `url` string
    - `storage_path` string
    - `captured_at` string
    - `job_id` number, nullable
    - `subtask_id` string, nullable
    - `label` string, nullable
    - `label_source` string, nullable
    - `capture_trigger` string, nullable
    - `verification_event_type` string, nullable

## Other responses

- `400` — Default Response
- `404` — Default Response
- `500` — Default Response

## Changes

- **2026-09-03** `a8bfa8f6865b` — 1 breaking, 7 info
  - the response property `frame` became nullable for the status `200`
  - added the new optional `query` request parameter `cached_only`
  - added the optional property `frame/capture_trigger` to the response with the `200` status
  - added the optional property `frame/job_id` to the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/printers/:id/frame/get.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/5f448e72f77d?raw)