# Wearfigs — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```