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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ford/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/ford/get-all-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ford/get-model-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","model":"<string>","postal_code":"<string>","year":"<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.