---
title: "List safe organization printer metadata with authoritative Host ownership"
method: GET
path: "/v1/hive-link/printers"
tags: ["Hive Link"]
---

# List safe organization printer metadata with authoritative Host ownership

`GET /v1/hive-link/printers`

## Query parameters

- `hostId` string, required

## Response `200`

Default Response

- object
  - `currentHost` object, required
    - `id` string, required
    - `name` string
    - `hostname` string
    - `lastSeenAt` string
    - `lastHeartbeatAt` string
  - `printers` object[], required
    - `id` string, required
    - `name` string, required
    - `serial` string
    - `ip` string
    - `model` string
    - `protocol` string, required
    - `ownership` object, required
      - `status` 'available' | 'unknown' | 'owned-by-this-host' | 'owned-by-another-host', required
      - `cloudPrinterId` string
      - `authoritativeHostId` string
      - `authoritativeHostName` string
      - `assignment` object
        - `id` string
        - `hostId` string
        - `hostName` string
        - `hostHostname` string
        - `leaseHostId` string
        - `leaseHostName` string
        - `assignmentEpoch` integer
        - `leaseExpiresAt` string
        - `connectionState` string
        - `lastKnownPrinterStatus` string
        - `recoveryRequired` boolean
        - `recoveryReason` string
        - `errorCode` string
        - `errorMessage` string
        - `retryCount` integer
        - `lastAttemptAt` string
        - `uploadInProgress` boolean
        - `outcome` string
        - `fromHostId` string
        - `toHostId` string
        - `state` string
        - `error` string

## Other responses

- `401` — Default Response
- `403` — Default Response
- `409` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/535140848bc4/schema)