# Honda — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Get current Honda Canada vehicle pricing, lease and finance payment options, APR rates, and available incentives across all Canadian provinces to compare deals in real-time. Calculate custom payment scenarios and browse all Honda models with their latest promotional offers directly from Honda Canada's official pricing data.

**Category:** Automotive | **Website:** [www.honda.ca/offers](https://www.honda.ca/offers) | **Docs:** [parse.bot/marketplace/48d82d83-8406-4c48-a78a-95b1b0ce80ca/honda-ca-api](https://parse.bot/marketplace/48d82d83-8406-4c48-a78a-95b1b0ce80ca/honda-ca-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/honda/`
**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 models

Get all available Honda Canada models with trims, transmissions, and MSRP pricing. Returns the full catalog of current models, each with nested trims and transmissions. Use this to discover model keys, trim keys, and transmission keys required by other endpoints.

**Estimated cost:** Metered

_No parameters required._

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

### Get offers

Get current incentive offers (lease bonus, finance bonus, cash incentives) for a specific vehicle transmission in a province. Returns offer arrays grouped by payment type. Use transmission keys from get_models.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `province` | string | No | Canadian province code (e.g., ON, BC, AB, QC). |
| `transmission_key` | string | Yes | Transmission key from get_models (e.g., '10938-Automatic', '10961-CVT', '10956-CVT'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/honda/get-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"province":"<string>","transmission_key":"<string>"}'
```

### Get payment calculation

Get detailed payment calculation for a specific vehicle configuration including monthly payment, APR, fees, levies, available terms, accessories, warranties, and color options. Requires model_key, trim_key, transmission_key, and color keys discoverable from get_models.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exterior_color_key` | string | Yes | Exterior color key (e.g., 'rallye_red', 'aegean_blue_metallic', 'crystal_black_pearl'). |
| `interior_color_key` | string | Yes | Interior color key (e.g., 'black_fabric', 'bkblack_fabric_^2021_civic_sedan'). |
| `model_key` | string | Yes | Model key from get_models (e.g., 'passport', 'civic_sedan', 'cr-v', 'pilot'). |
| `model_year` | integer | No | Model year. |
| `payment_method` | string | No | Payment method: 'lease' or 'finance'. |
| `province` | string | No | Canadian province code (e.g., ON, BC, AB, QC). |
| `term` | integer | No | Term in months. |
| `transmission_key` | string | Yes | Transmission key from get_models (e.g., '10938-Automatic', '10956-CVT'). |
| `trim_key` | string | Yes | Trim key from get_models (e.g., 'trailsport_10890', 'lx_10908'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/honda/get-payment-calculation \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"exterior_color_key":"<string>","interior_color_key":"<string>","model_key":"<string>","model_year":"<integer>","payment_method":"<string>","province":"<string>","term":"<integer>","transmission_key":"<string>","trim_key":"<string>"}'
```

### Get vehicle deals

Get comprehensive vehicle deals for a province filtered by model, including MSRP, lease/finance payment calculations, APR rates, available terms, and current incentive offers. Payment calculations are provided for up to 5 vehicles per request. Matches model filter as substring against model name and key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model` | string | Yes | Filter by model name or key. Matches as substring against model name and key (e.g., 'civic_sedan', 'cr-v', 'passport', 'pilot', 'odyssey', 'ridgeline', 'hr_v', 'accord_sedan', 'prologue', 'prelude', 'civic_hatchback', 'civic_sedan_si'). |
| `province` | string | No | Canadian province code (e.g., ON, BC, AB, QC). |

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

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.