API Endpoint Reference / Materials

List the stock filament profiles a material type can use on a printer

GET https://api.printhiv3d.com/v1/filament-profiles/compatible

Operation ID listCompatibleFilamentProfiles. Requires the read API key scope.

Pass a listed bambuFilamentId when you upsert a catalog filament. A stored profile changes how a plate slices and how the color assigns to a printer only for an organization with the hiveslice_loaded_filament_profiles flag, which stays off until the runtime is qualified.

Parameters

NameInTypeRequiredDescription
materialquerystringYesMaterial type of the color, such as PETG or PLA Matte.
printerIdqueryuuidYesA printer in your organization. Its model and nozzle set the target.

Responses

StatusDescription
200Default Response

200 response fields

FieldTypeRequiredDescription
materialstringYes
targetobjectYes
profilesobject[]Yes

Example 200 response

{
  "material": "PLA",
  "target": {
    "printerModel": "P1S",
    "nozzleDiameter": 0.4
  },
  "profiles": [
    {
      "bambuFilamentId": "GFA00",
      "vendor": "Bambu Lab",
      "name": "PLA Basic",
      "settingId": "GFSA00_03",
      "isDefault": true
    }
  ]
}