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

> Browse all BMW USA vehicle models, specifications, and current offers in one place, with dedicated access to electric models and high-performance M-Series vehicles. Get detailed information about any BMW model including pricing, features, and available promotions.

**Category:** Automotive | **Website:** [bmwusa.com/](https://bmwusa.com/) | **Docs:** [parse.bot/marketplace/89a42947-57d9-4e0d-b1dc-58b11d38b742/bmwusa-com-api](https://parse.bot/marketplace/89a42947-57d9-4e0d-b1dc-58b11d38b742/bmwusa-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-bmwusa-com-api-89a42947/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_models

Returns all BMW vehicle models available on bmwusa.com. Each vehicle includes performance specs (horsepower, acceleration, MPG), pricing, drivetrain, fuel type, series, body style, and image URLs. Results span all series and body styles in the current model year lineup.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bmwusa-com-api-89a42947/get_all_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_all_offers

Returns all current national lease and finance offers for BMW models. Each offer includes vehicle name, code, offer type, payment terms (monthly payment, term length, due at signing), loyalty credit, validity period, and MSRP. Offers refresh monthly.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bmwusa-com-api-89a42947/get_all_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bmw_m_models

Returns the BMW M performance lineup, including both full M models (is_m=true) and M Performance models (is_m_performance=true). Same vehicle detail fields as get_all_models, filtered to M-badged vehicles.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bmwusa-com-api-89a42947/get_bmw_m_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_electric_models

Returns BMW's lineup of all-electric (fuel_type 'E') and plug-in hybrid (fuel_type 'X') vehicles. Same vehicle detail fields as get_all_models, filtered to electric and PHEV powertrains only.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bmwusa-com-api-89a42947/get_electric_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_model_details

Returns detailed information for a specific BMW vehicle by its code. Includes full specs, current lease offer details (monthly payment, term, due at signing, loyalty credit, validity dates), disclaimers, image URLs, and configuration flags. Vehicle codes are discoverable from get_all_models results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vehicle_code` | string | Yes | BMW vehicle code identifying the model (e.g. '262B' for 230i Coupe, '262C' for M240i Coupe). Codes can be discovered from the code field in get_all_models results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bmwusa-com-api-89a42947/get_model_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vehicle_code":"<string>"}'
```