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

> Retrieve available configurations—trims, powertrains, packages, and exterior/interior colors with pricing—for Hyundai vehicle models, and generate 360° visualization image URLs for any valid configuration combination.

**Category:** Automotive | **Website:** [www.hyundai.com/de/de/modelle/bayon/konfigurator.html#/trims](https://www.hyundai.com/de/de/modelle/bayon/konfigurator.html#/trims) | **Docs:** [parse.bot/marketplace/59009a76-0a1b-49b1-8490-26c54e92d0c5/hyundai-com-api](https://parse.bot/marketplace/59009a76-0a1b-49b1-8490-26c54e92d0c5/hyundai-com-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-hyundai-com-api-59009a76/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_configurations

Get all available configurations for a Hyundai model, including trims, powertrains, packages, exterior/interior colors, and prices. Returns FSC codes, color codes, and interior color codes needed for the get_image_urls endpoint. Currently only the German market (country 'de') is supported by the upstream API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code. Only 'de' (Germany) is confirmed working. |
| `language` | string | No | Language code. Only 'de' is confirmed working. |
| `model_id` | string | No | Model name or raw model ID. Confirmed working values: 'bayon', 'i10', 'i20', 'i30', 'kona', 'tucson', 'ioniq5', 'ioniq6', 'santa-fe'. Raw model IDs like 'SW\|W5\|\|' are also accepted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hyundai-com-api-59009a76/get_configurations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","language":"<string>","model_id":"<string>"}'
```

### get_image_urls

Generate 360° configurator image URLs for a specific car configuration. Uses the same hash algorithm as the Hyundai configurator to construct CDN image URLs. Returns up to 36 angles (10° increments). Use get_configurations first to discover valid FSC, ext_color, and int_color values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code in uppercase (e.g. 'DE'). |
| `ext_color` | string | Yes | Exterior color code from get_configurations (e.g. 'A7G' for Aurora Grey). |
| `frames` | string | No | Comma-separated frame numbers (1-36) to generate. Omit or leave empty for all 36 frames. |
| `fsc` | string | Yes | Full Specification Code from get_configurations (e.g. 'SWW5K5G17CC440'). |
| `height` | integer | No | Image height in pixels. |
| `int_color` | string | Yes | Interior color code from get_configurations (e.g. 'NNB'). |
| `width` | integer | No | Image width in pixels. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hyundai-com-api-59009a76/get_image_urls \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","ext_color":"<string>","frames":"<string>","fsc":"<string>","height":"<integer>","int_color":"<string>","width":"<integer>"}'
```