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

> Access Patagonia's full product catalog via search and category browsing. Retrieve detailed product information including variants, pricing, specs, and materials. Fetch customer reviews, locate nearby stores and authorized dealers, and browse the Worn Wear used and refurbished gear selection.

**Category:** E-commerce | **Website:** [patagonia.com/](https://patagonia.com/) | **Docs:** [parse.bot/marketplace/bab1abce-5111-4d31-b476-9e02675b9bce/patagonia-com-api](https://parse.bot/marketplace/bab1abce-5111-4d31-b476-9e02675b9bce/patagonia-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/patagonia/`
**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

### Find stores

Find nearby Patagonia stores and authorized dealers based on geographic coordinates. Returns store details including address, phone, hours, distance, and open/closed status. Results are sorted by proximity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dist` | integer | No | Search radius distance in miles. |
| `lat` | number | Yes | Latitude of search center (e.g. 40.7128 for NYC, 37.7749 for San Francisco). |
| `lng` | number | Yes | Longitude of search center (e.g. -74.0060 for NYC, -122.4194 for San Francisco). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/patagonia/find-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"dist":"<integer>","lat":"<number>","lng":"<number>"}'
```

### Get category products

Browse products within a specific Patagonia category. Returns the same product structure as search with offset-based pagination. Category IDs are URL slugs visible in patagonia.com category pages (e.g. 'mens-jackets-vests', 'womens-fleece').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID slug (e.g. 'mens-jackets-vests', 'womens-fleece', 'mens-baselayers'). |
| `start` | integer | No | Offset for pagination (increments by sz value each page). |
| `sz` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/patagonia/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","start":"<integer>","sz":"<integer>"}'
```

### Get product details

Retrieve complete product details including per-color pricing, available variants (color and size), images per color, fit information, specs, and materials. Requires a product ID (style number) from search or category results. Makes two requests: one to load the product page and one to fetch variation attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pid` | string | Yes | Product ID / style number (e.g. '84213', '68460') from search_products or get_category_products results. |

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

### Get product reviews

Fetch customer reviews for a product from Yotpo. Returns paginated reviews with rating scores, content, reviewer info, and an aggregate bottomline with average score and star distribution. Pagination is page-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for review pagination. |
| `per_page` | integer | No | Number of reviews per page. |
| `pid` | string | Yes | Product ID (e.g. '68460', '84213') from search_products or get_category_products results. |

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

### Get worn wear products

List available Worn Wear (used/refurbished) Patagonia products from the Worn Wear Shopify store. Returns up to 50 products with title, condition, pricing (including compare_at_price for savings calculation), images, and variant options. No pagination parameters — returns the most recently listed items.

**Estimated cost:** Metered

_No parameters required._

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

### Search products

Full-text search across the Patagonia product catalog. Returns paginated product listings with name, price, brand, and category. Pagination is offset-based: advance by incrementing start by sz each page. The response includes has_next to signal more results and next_start for the next offset value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'backpack', 'jacket', 'fleece'). |
| `start` | integer | No | Offset for pagination (increments by sz value each page). |
| `sz` | integer | No | Number of results per page. |

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

## Next steps

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