---
title: "List the stock filament profiles a material type can use on a printer"
method: GET
path: "/v1/filament-profiles/compatible"
tags: ["Materials", "Public"]
---

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

`GET /v1/filament-profiles/compatible`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/filament-profiles/compatible`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

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.

## Query parameters

- `material` string, required
- `printerId` string, uuid, required

## Response `200`

Default Response

- object
  - `material` string, required
  - `target` object, required
    - `printerModel` string, required
    - `nozzleDiameter` number, required
  - `profiles` object[], required
    - `bambuFilamentId` string, required: Pass this as bambuFilamentId when you upsert a catalog filament.
    - `vendor` string, required
    - `name` string, required
    - `settingId` string, required: The printer-specific setting this profile takes on the target.
    - `isDefault` boolean, required: True for the profile a catalog filament takes when you omit bambuFilamentId.

## Other responses

- `default`: Unexpected error response

## Changes

- **2026-11-18** `eafa8d21ea40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/filament-profiles/compatible/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/87c698b4576a?raw)
