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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-honda-ca-api-48d82d83/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-honda-ca-api-48d82d83/get_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-honda-ca-api-48d82d83/get_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-honda-ca-api-48d82d83/get_payment_calculation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-honda-ca-api-48d82d83/get_vehicle_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<string>","province":"<string>"}'
```