Get all variants

GET /v1/materials/variants

List all material variants (specific colors/brands of a material type)

Requires: material.view

Response Schema

MaterialVariant[]

Array of MaterialVariant, each with:

colorrequirednullable

string

pattern: ^#([A-Fa-f0-9]{8})(;#([A-Fa-f0-9]{8}))*$

createdAtrequired

string

format: date-time

customMetadataoptional

Record<string, any>

Construct a type with a set of properties K of type T

externalIdoptionalnullable

string

filamentSystemProfileIdrequirednullable

number

filamentUserProfileIdrequirednullable

string

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

idrequired

string

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

materialIdrequired

string

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

namerequired

string

pressureAdvanceoptionalnullable

number

min: 0max: 2

pricePer1000goptionalnullable

integer

Price per kg, in cents. Overrides the material's price when set.

sourceoptionalnullable

string

storeIdrequired

string

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

tagsrequired

string[]

updatedAtrequired

string

format: date-time

Example Response

200 OK — application/json

[
  {
    "name": "string",
    "materialId": "string",
    "color": "string",
    "tags": [
      "string"
    ],
    "filamentUserProfileId": "string",
    "filamentSystemProfileId": 1,
    "pricePer1000g": 1,
    "pressureAdvance": 0,
    "source": "string",
    "externalId": "string",
    "customMetadata": {},
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  }
]