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

> Explore Rolex's complete watch catalog to compare models, editions, and specifications, then check pricing and locate nearby authorized stores. Access user guides and brochures to learn more about any timepiece.

**Category:** E-commerce | **Website:** [rolex.com/](https://rolex.com/) | **Docs:** [parse.bot/marketplace/22eb18da-f5ff-4cb8-be70-19a1a286ffc4/rolex-com-api](https://parse.bot/marketplace/22eb18da-f5ff-4cb8-be70-19a1a286ffc4/rolex-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/rolex/`
**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 store locator

Find Rolex retailers and service centers filtered by country. Returns establishment names, addresses, coordinates, opening hours, contact information, and store type (STORE or SERVICECENTER).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO 2-letter country code to filter results (e.g. 'US', 'GB', 'FR', 'DE', 'JP'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/rolex/find-store-locator \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>"}'
```

### Get all watch models

Get all Rolex watch model families with their names, slugs, taglines, categories, and image URLs. Returns classic, professional, and 'find your Rolex' category models. Each model includes a slug that can be used to fetch detailed model pages or edition listings.

**Estimated cost:** Metered

_No parameters required._

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

### Get brochures list

Get all available brochures metadata including titles, subtitles, family codes, reference numbers, and file paths. Returns page components containing cover headings and download sections with brochure elements.

**Estimated cost:** Metered

_No parameters required._

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

### Get user guides list

Get all available user guides metadata including titles, family codes, and file paths for Rolex watch models and accessories. Returns page components containing cover headings and download sections with user guide elements.

**Estimated cost:** Metered

_No parameters required._

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

### Get watch edition detail

Get full specifications and pricing for a specific watch reference. Returns detailed case, dial, bracelet, movement specs, editorial mapping, and US pricing including formatted price string.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `reference` | string | Yes | The watch reference number (e.g. 'm124060-0001', 'm126613lb-0002'). Obtain from get_watch_editions_by_model results. |

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

### Get watch editions by model

List all individual watch editions/references for a given model family via Coveo search. Returns reference numbers, case descriptions, image URLs, and product page URLs for each edition in the family.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `family_code` | string | Yes | The family code of the model (e.g. 'submariner', 'cosmograph-daytona', 'datejust'). Obtain from get_all_watch_models results. |

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

### Get watch model detail

Get the full CMS page data for a specific model family, including cover media, editorial content, navigation structure, and metadata. Returns rich content components such as covers, video players, roller galleries, and sub-navigation items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_slug` | string | Yes | The slug of the model family (e.g. 'submariner', 'cosmograph-daytona', 'datejust'). Obtain from get_all_watch_models results. |

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

### Search watches

Search for watches and other Rolex content by keyword via Coveo search. Returns matching results including watches, articles, and retailer listings with title, URI, excerpt, and raw metadata fields. Results are ranked by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Daytona', 'gold', 'submariner') |

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