---
title: "Get printers ranked by compatibility with a file"
method: GET
path: "/v1/files/{fileId}/compatible-printers"
tags: ["Files"]
---

# Get printers ranked by compatibility with a file

`GET /v1/files/{fileId}/compatible-printers`

Returns all printers in the organization ranked by their compatibility with the specified model file. Considers printer model, available filament slots, and material matching with color proximity.

## Path parameters

- `fileId` string, uuid, required

## Query parameters

- `organizationId` string, uuid
- `includeOffline` 'true' | 'false'
- `makeId` string, uuid
- `colorThreshold` number
- `materialIds` string
- `acceptableMaterials` string
- `strategyExactMaterial` 'true' | 'false'
- `strategyTypeColor` 'true' | 'false'
- `strategyLooseMatch` 'true' | 'false'

## Response `200`

Default Response

- object
  - `file` object
    - `id` string
    - `filename` string
    - `sliced_for_model` unknown
    - `sliced_for_model_display` unknown
    - `required_filaments` object[]
      - `index` number
      - `type` string
      - `color` string
      - `used_grams` number
  - `printers` object[]
    - `printer_id` string
    - `name` string
    - `model` string
    - `model_id` unknown
    - `score` number
    - `match_type` string
    - `reasons` string[]
    - `is_connected` boolean
    - `compatibility_details` object
    - `loaded_filaments` object[]
    - `state_observed_at` unknown
    - `material_evidence` object
    - `material_evidence_gate` object

## Other responses

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

## Changes

- **2026-09-24** `afa283b82594` — 1 info
  - added the optional property `printers/items/loaded_filaments` to the response with the `200` status
- **2026-09-23** `49b549b68d52` — 2 breaking, 2 warning
  - for the `query` request parameter `colorThreshold`, default value was changed from `15` to `15`
  - for the `query` request parameter `colorThreshold`, the type changed from `string` to `number`
  - for the `query` request parameter `colorThreshold`, the max was set to `100.00`
  - for the `query` request parameter `colorThreshold`, the min was set to `0.00`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/files/:fileId/compatible-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/5f448e72f77d?raw)