---
title: "List organization printers and loaded filament"
method: GET
path: "/v1/printers"
tags: ["Public", "Printers"]
---

# List organization printers and loaded filament

`GET /v1/printers`

## Request

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

## Query parameters

- `limit` integer
- `cursor` string, uuid

## Response `200`

Default Response

- object
  - `printers` object[], required
    - `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
  - `nextCursor` string, uuid, 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/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)