Get printer slot by ID

GET /v1/materials/printer-slots/{id}

Get a specific printer slot configuration

Requires: printer.view

Path Parameters

id required

string

Slot ID

Response Schema

PrinterSlot

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}$

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",
  "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"
}