Get all printer slots

GET /v1/materials/printer-slots

List all printer filament slot configurations

Requires: printer.view

Response Schema

PrinterSlot[]

Array of PrinterSlot, each with:

amsIndexrequired

number

Visual slot position: -1 for spool, 0+ for AMS array index

createdAtrequired

string

format: date-time

expectedDatarequirednullable

object

colorrequired

string

identifierrequired

string

identifiersoptional

string[]

Every `info` value the printer might legitimately echo back for this assignment. Only Bambu (`tray_info_idx`) and first-party Creality (canonical code) can round-trip `identifier` itself — the U1 echoes its RFID SKU or type string, Anycubic its read-only RFID SKU, Elegoo nothing at all — so the expected-check accepts any member of this set (plus an empty `info` when type+color match). Contains at least `identifier` and the `trayType` sent to the printer; assignment flows that know the slot's currently-reported `info` (RFID SKU etc.) include it too, pinning the assignment to the observed physical spool. Absent on rows written before this field existed — readers fall back to `[identifier]`.

typerequired

string

expectedDataSetAtrequirednullable

string

format: date-time

filamentSystemProfileIdrequirednullable

number

filamentUserProfileIdrequirednullable

string

pattern: ^[a-z0-9]{24}$

idrequired

string

pattern: ^[a-z0-9]{24}$

instanceIdrequirednullable

string

pattern: ^[a-z0-9]{24}$

materialIdrequirednullable

string

pattern: ^[a-z0-9]{24}$

materialTyperequirednullable

string

printerIdrequired

string

pattern: ^[a-z0-9]{24}$

serialrequirednullable

string

Serial of the roll physically in this slot, null when unknown.

serialSourcerequirednullable

"tag" | "manual" | "integration"

tagmanualintegration

slotoptional

number

min: -64max: 255

slotIndexrequired

number

Slot within AMS, or spool index for multiple spools

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

updatedAtrequired

string

format: date-time

variantIdrequirednullable

string

pattern: ^[a-z0-9]{24}$

Example Response

200 OK — application/json

[
  {
    "printerId": "string",
    "materialId": "string",
    "variantId": "string",
    "instanceId": "string",
    "materialType": "string",
    "expectedData": {
      "color": "string",
      "identifier": "string",
      "type": "string",
      "identifiers": [
        "string"
      ]
    },
    "expectedDataSetAt": "2025-01-15T12:00:00.000Z",
    "serial": "string",
    "serialSource": "tag",
    "amsIndex": 1,
    "slotIndex": 1,
    "slot": -64,
    "filamentUserProfileId": "string",
    "filamentSystemProfileId": 1,
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  }
]