# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bmwusa/`
**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 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/credits/bmwusa/get-all-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bmwusa/get-all-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bmwusa/get-bmw-m-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bmwusa/get-electric-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bmwusa/get-model-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"vehicle_code":"<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.