---
title: "Read an organization printer and loaded filament"
method: GET
path: "/v1/printers/{id}"
tags: ["Public", "Printers"]
---

# Read an organization printer and loaded filament

`GET /v1/printers/{id}`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/printers/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

- object
  - `id` string, uuid, required
  - `name` string, required
  - `make` string, required
  - `model` string, required
  - `modelId` unknown, required
  - `family` string, required
  - `nozzleDiameter` unknown, required
  - `buildPlate` unknown, required
  - `connected` unknown, required
  - `readyMarked` boolean, required
  - `readiness` object, required
    - `ready` boolean, required
    - `bedClear` unknown, required
  - `maintenance` boolean, required
  - `state` 'idle' | 'printing' | 'paused' | 'offline' | 'maintenance' | 'ready-marked' | 'unknown', required
  - `loadedFilament` object[], required
    - `slot` string, required
    - `position` integer, required
    - `address` object, required
      - `ams_id` integer, required
      - `slot_id` integer, required
    - `state` 'loaded' | 'empty' | 'unknown', required
    - `material` unknown, required
    - `color` unknown, required
    - `colorHex` unknown, required

## Other responses

- `default`: Unexpected error response

## Changes

- **2026-10-31** `d155353b33e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/printers/:id/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/5c27b7de1bed?raw)