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

> Build your ideal CUPRA vehicle by browsing all available models, trim levels, engines, colors, wheels, and upholstery options while viewing real-time pricing and product images for any configuration. Customize your build by adding optional equipment and exploring how different upgrades affect your final vehicle.

**Category:** Automotive | **Website:** [www.cupraofficial.de/carshop/w/model](https://www.cupraofficial.de/carshop/w/model) | **Docs:** [parse.bot/marketplace/88989b69-4e10-410f-a00a-266a8f24216e/cupraofficial-de-api](https://parse.bot/marketplace/88989b69-4e10-410f-a00a-266a8f24216e/cupraofficial-de-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-cupraofficial-de-api-88989b69/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_configuration_details

Get full configuration details including available engines/powertrains, exterior colors, wheels, upholstery, current pricing, and product images for a specific configuration. Makes multiple GraphQL queries internally to assemble the complete view. Each option array entry includes selection state, pricing, and image URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `configuration_id` | string | Yes | Configuration ID from list_models, get_trims, or update_configuration endpoint. |
| `language` | string | No | Language code for responses. |
| `market_code` | string | No | Market code (e.g. '007' for Germany). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cupraofficial-de-api-88989b69/get_configuration_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<string>","language":"<string>","market_code":"<string>"}'
```

### get_optional_equipment

Get available optional equipment and packages for a configuration, including discount packages, exterior/interior accessories, safety systems, and multimedia options. Each item includes pricing, images, category, and constituent parts for packages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `configuration_id` | string | Yes | Configuration ID to get equipment options for. |
| `language` | string | No | Language code for responses. |
| `market_code` | string | No | Market code (e.g. '007' for Germany). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cupraofficial-de-api-88989b69/get_optional_equipment \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<string>","language":"<string>","market_code":"<string>"}'
```

### get_trims

Get available trim levels for a specific model. Returns trim keys, names, descriptions, base configuration IDs, and highlight features. Each trim carries its own base_configuration_id usable for further drill-down into configuration details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `configuration_id` | string | Yes | Configuration ID from list_models endpoint (models[*].configuration_id). |
| `language` | string | No | Language code for responses. |
| `market_code` | string | No | Market code (e.g. '007' for Germany). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cupraofficial-de-api-88989b69/get_trims \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<string>","language":"<string>","market_code":"<string>"}'
```

### list_models

List all available CUPRA vehicle models with default pricing, engine types, efficiency data, and technical specifications. Each model carries a configuration_id that scopes all downstream endpoints (trims, configuration details, optional equipment, updates). Returns the full catalog in a single page — no pagination token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language code for responses. |
| `market_code` | string | No | Market code (e.g. '007' for Germany). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cupraofficial-de-api-88989b69/list_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","market_code":"<string>"}'
```

### update_configuration

Add or change equipment in a configuration (e.g., select a different color, wheel, or package). Returns a new configuration ID reflecting the changes, a validity flag, and any conflicts that arose. The new configuration_id can be fed back into get_configuration_details or further update calls to chain modifications.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `configuration_id` | string | Yes | Current configuration ID to modify. |
| `equipment_codes` | string | Yes | Comma-separated equipment codes to add (e.g. 'F14 2Y2Y' for Glacial White color, 'GZ9AZ9A' for 19" Cosmic wheels, 'F14 2Y2Y,GZ9AZ9A' for multiple). |
| `language` | string | No | Language code for responses. |
| `market_code` | string | No | Market code (e.g. '007' for Germany). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cupraofficial-de-api-88989b69/update_configuration \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<string>","equipment_codes":"<string>","language":"<string>","market_code":"<string>"}'
```