# Wearfigs — 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.

> Browse and search FIGS medical apparel across women's and men's collections. Filter by category, fabric, color, and size, and surface new arrivals, best sellers, and sale items with detailed product information and customer reviews. Use the complete-the-set feature to retrieve coordinating product variants for any item.

**Category:** E-commerce | **Website:** [wearfigs.com/](https://wearfigs.com/) | **Docs:** [parse.bot/marketplace/9dabc540-6806-4631-8d13-90bdffd37beb/wearfigs-com-api](https://parse.bot/marketplace/9dabc540-6806-4631-8d13-90bdffd37beb/wearfigs-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/wearfigs/`
**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 available colors

Fetch available colors for a product, categorized into Core and Limited Edition groups. Each color includes name, ID, hex codes, swatch URL, and accent color.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product group handle/slug (e.g. 'womens-catarina-scrub-top'). |

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

### Get available sizes

Fetch available sizes and fits for a specific product. Returns arrays of size labels and fit options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product group handle/slug (e.g. 'womens-catarina-scrub-top'). |

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

### Get best sellers

Fetch best-selling products for a specific gender. Returns a collection of top-selling products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender: 'womens' or 'mens'. |

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

### Get collection by category

Fetch products from a specific category collection by its handle. Returns all products in that category with color and group metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category collection handle (e.g. 'scrub-tops-womens', 'scrub-pants-mens', 'scrub-tops-mens', 'scrub-pants-womens'). |

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

### Get collection by fabric

Fetch products by fabric technology name with optional gender filter. Uses search to find products matching the fabric. Results can be filtered by gender when provided in the handle.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fabric` | string | Yes | Fabric handle with optional gender suffix. Accepted formats: 'fionx-womens', 'fionx-mens', 'formx-womens', 'formx-mens', 'fibrex-womens', 'fibrex-mens', 'fionx', 'formx', 'fibrex'. |

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

### Get complete the set

Fetch product variant data for given SKUs. Returns variant details including pricing, Shopify IDs, and associated product group information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `skus` | string | Yes | JSON array of SKU strings (e.g. '["1001567A01001:SR"]'). SKU format is typically product-code:size-fit. |

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

### Get mens scrubs collection

Fetch all men's scrub products from the 'all-scrubs-mens' collection. Returns every product in the collection with color and category metadata. No pagination — a single request returns all items.

**Estimated cost:** Metered

_No parameters required._

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

### Get new arrivals

Fetch new arrival products for a specific gender. Returns a collection of recently added products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender: 'womens' or 'mens'. |

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

### Get product detail

Fetch detailed product information including available colors, sizes, fits, materials, and features for a given product handle. The handle can be a color-specific variant slug or a product group slug. Returns the product catalog options and product metadata. When a product group handle is used, the 'product' field may be null — use a color-specific handle for full product metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `color` | string | No | Optional color name filter (currently unused by upstream but accepted for compatibility). |
| `handle` | string | Yes | Product handle/slug — either a color-specific handle (e.g. 'womens-catarina-one-pocket-scrub-top-black') or a product group handle (e.g. 'womens-catarina-scrub-top'). |

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

### Get product reviews

Fetch customer reviews for a specific product by its Shopify product ID. Returns paginated reviews with rating scores, review text, and pagination metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of reviews per page. |
| `page` | integer | No | Page number for pagination. |
| `product_id` | string | Yes | Shopify product ID (numeric string, e.g. '6999109206192'). |

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

### Get sale products

Fetch products currently on sale for a specific gender. Returns a collection of discounted products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender: 'womens' or 'mens'. |

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

### Get womens scrubs collection

Fetch all women's scrub products from the 'all-scrubs-womens' collection. Returns every product in the collection with color and category metadata. No pagination — a single request returns all items.

**Estimated cost:** Metered

_No parameters required._

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

### Search products

Search for products by keyword across the entire catalog. Returns matching products with color and category metadata, plus search suggestions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return (currently not enforced server-side; all matching results are returned). |
| `query` | string | Yes | Search keyword (e.g. 'scrub top', 'jogger pants', 'jacket'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wearfigs/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","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.