---
title: "Read job state and the exact current Start Print attempt"
method: GET
path: "/v1/print-jobs/{id}/control-state"
tags: ["Print Jobs"]
---

# Read job state and the exact current Start Print attempt

`GET /v1/print-jobs/{id}/control-state`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/print-jobs/{id}/control-state`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/printhiv3d/apis/hive-api-documentation/docs/v1/print-jobs/:id/control-state/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Response `200`

Default Response

- object
  - `jobId` integer, required
  - `status` string, required
  - `printerId` string, nullable, required
  - `startAttemptId` string, nullable, required
  - `stopAvailability` 'ready' | 'not_ready' | 'not_active' | 'unsupported', required
  - `canCancelWithoutStop` boolean, required
  - `reason` string, nullable, required
  - `printerFamily` string, nullable, required
  - `message` string, nullable, required

## Other responses

- `404`: Default Response
- `409`: Default Response
- `503`: Default Response

## Changes

- **2026-11-10** `09f2403145b5`: 3 info
  - api operation id `getPrintJobControlState` was added
  - the endpoint scheme security `apiKeyAuth` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-11-10** `78d74bd36d6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/print-jobs/:id/control-state/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/35a7515c29d5?raw)