# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wearfigs-com-api-9dabc540/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-wearfigs-com-api-9dabc540/get_available_colors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_available_sizes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_best_sellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_collection_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_collection_by_fabric \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_complete_the_set \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_mens_scrubs_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_sale_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/get_womens_scrubs_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wearfigs-com-api-9dabc540/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```