# Colorfabb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access ColorFabb's full filament catalog, including material specifications, pricing, RAL color listings, and customer review ratings. Search and filter products by material type, color, and keyword to compare filaments across categories.

**Category:** E-commerce | **Website:** [colorfabb.com/](https://colorfabb.com/) | **Docs:** [parse.bot/marketplace/4482897d-55cc-4488-9ba5-4d684cfea5ea/colorfabb-com-api](https://parse.bot/marketplace/4482897d-55cc-4488-9ba5-4d684cfea5ea/colorfabb-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/colorfabb/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all filaments

Retrieve a paginated list of all filaments with basic details and configurations. Returns up to 12 products per page. Supports filtering by material category ID. Paginate by incrementing the page parameter until products array is empty or current_page exceeds total_count / 12.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `material` | string | No | Material category ID to filter by (e.g. '17285' for PLA High Speed Pro). IDs available from get_filament_categories endpoint. |
| `page` | integer | No | Page number (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/get-all-filaments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"material":"<string>","page":"<integer>"}'
```

### Get filament categories

List all filament material categories and their product counts. No parameters required. Returns category names, IDs (used as material filter in get_all_filaments), and item counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/get-filament-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get filament detail

Retrieve full details for a single filament product by its URL slug, including name, SKU, description, specifications, and printing advice. Returns stale_input if the product slug does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product URL slug (e.g. 'varioshore-tpu-black', 'pla-high-speed-pro-natural'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/get-filament-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get filament reviews

Retrieve aggregate ratings for a specific product ID from the review provider. Returns total review count and average score. Product IDs are available from the id field in get_all_filaments or get_ral_colors results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Internal product entity ID (e.g. '9020', '1525'). Available from the id field in get_all_filaments or get_ral_colors results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/get-filament-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### Get ral colors

Retrieve all RAL color filaments with pagination. Returns up to 12 products per page. Each product includes name, price, stock status, and configuration options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/get-ral-colors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search filaments

Search for filaments by keyword using the site's autocomplete search. Returns matching products with basic details including SKU, name, description, price, and URL. Results are not paginated; the response returns the top matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'PLA', 'TPU', 'black'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/colorfabb/search-filaments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.