# SIR the Label — 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.

> Search and browse SIR. The Label's fashion products, view detailed product information, check loyalty program benefits, and access help and policy pages. Perfect for exploring the brand's offerings and understanding their customer programs.

**Category:** E-commerce | **Website:** [sirthelabel.com/](https://sirthelabel.com/) | **Docs:** [parse.bot/marketplace/8c5bbcf6-224f-43d4-985e-11bd7a69615f/sirthelabel-com-api](https://parse.bot/marketplace/8c5bbcf6-224f-43d4-985e-11bd7a69615f/sirthelabel-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/sir-the-label/`
**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 loyalty program

Get the SIR. Loyalty program configuration including tier structure, point earning rules, referral incentives, and program settings. No authentication required - returns the public program information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code for localized loyalty info (e.g. 'US', 'AU'). |

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

### Get page

Get the content of a help, policy, or informational page by its handle. Returns the page title, HTML body content, and plain text summary. Useful for shipping info, returns, privacy policy, terms, contact details, etc.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Page URL handle/slug. Known pages include: shipping-delivery, privacy-policy, terms-conditions, contact-us, payment-2, store-locator, warehouse-t-cs. |

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

### Get product

Get full product details by handle, including description, all images, size/color options, variant availability and pricing. The handle is the URL slug from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product URL handle/slug (e.g. 'phillipa-shirt-dress-eira-midnight'). Available from search_products results[*].handle. |

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

### Search products

Search products on SIR. The Label using full-text search with faceted filtering and pagination. Returns matching products with pricing, availability, images, and facet breakdowns for further filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search query text (e.g. 'dress', 'silk top', 'midi skirt'). |
| `results_per_page` | integer | No | Number of results per page. |
| `sort_direction` | string | No | Sort direction. Accepts: asc, desc. |
| `sort_field` | string | No | Field to sort by. Accepts: relevance, ss_days_since_published, ga_unique_purchases, ss_price. |

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