# Ford — 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 Ford vehicle deals, financing rates, lease terms, and cash rebates available in Canada, complete with vehicle images and links to specific models. Compare incentives across Ford's lineup to find the best offers for your next vehicle purchase.

**Category:** Automotive | **Website:** [www.ford.ca/offers/](https://www.ford.ca/offers/) | **Docs:** [parse.bot/marketplace/7c9ef10a-3db1-4457-b530-06e0bab4dc07/ford-ca-api](https://parse.bot/marketplace/7c9ef10a-3db1-4457-b530-06e0bab4dc07/ford-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-ford-ca-api-7c9ef10a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_offers

Get all current vehicle deals and offers across Ford Canada models. Returns financing details (APR, terms), lease details (APR, terms), cash incentives/rebates, vehicle images, and vehicle page URLs for each model/trim combination. When model is omitted, queries a default set of popular models (F-150, Maverick, Bronco, Bronco Sport, Explorer, Escape, Ranger, F-150 Lightning, Mustang Mach-E). Postal code affects province-specific incentive availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for offer details: EN or FR |
| `model` | string | No | Filter to a specific model name. If empty, returns all models. |
| `postal_code` | string | No | Canadian postal code for regional offers (affects province-specific incentives). Format: 6 alphanumeric characters without space (e.g. L6J5E4). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ford-ca-api-7c9ef10a/get_all_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","model":"<string>","postal_code":"<string>"}'
```

### get_model_offers

Get detailed offers for a specific Ford Canada vehicle model, including per-trim financing, lease, and cash incentive breakdowns plus model-level campaign offers. Returns trim-level arrays of financing/lease/cash programs and a separate model_offers object for nameplate-wide campaigns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for offer details: EN or FR |
| `model` | string | Yes | Vehicle model name to look up offers for. |
| `postal_code` | string | No | Canadian postal code for regional offers. Format: 6 alphanumeric characters without space (e.g. L6J5E4). |
| `year` | string | No | Model year (e.g., '2025', '2026'). If not provided, uses the current offer year for that model. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ford-ca-api-7c9ef10a/get_model_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","model":"<string>","postal_code":"<string>","year":"<string>"}'
```
