---
title: "Match a printer's loaded filament to its next job"
method: GET
path: "/v1/printers/{id}/next-job-material-match"
tags: ["Filament lifecycle"]
---

# Match a printer's loaded filament to its next job

`GET /v1/printers/{id}/next-job-material-match`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/printers/{id}/next-job-material-match`
- Auth: none declared

Names the job the printer would take next: one assigned to it, else the highest-priority queued job it is eligible for on every Smart Queue rule except filament. Reports whether the printer's saved filament and presence satisfy that job, with a load plan grouped by toolhead, extruder and AMS unit when they do not. Reading sends nothing to the printer and claims nothing.

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

## Other responses

- `default`: Unexpected error response

## Changes

- **2026-10-31** `906fa9f15f12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/printers/:id/next-job-material-match/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)