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

> Access Toyota's full vehicle lineup, trim-level specifications, current promotional offers, and dealer locations — all from a single API. Compare models side-by-side, retrieve financing and lease deals by ZIP code, and find authorized dealerships near any US address.

**Category:** Automotive | **Website:** [toyota.com/](https://toyota.com/) | **Docs:** [parse.bot/marketplace/7b35dbaf-ab48-49c5-b1dc-32c4d9c1277b/toyota-com-api](https://parse.bot/marketplace/7b35dbaf-ab48-49c5-b1dc-32c4d9c1277b/toyota-com-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/toyota/`
**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 vehicles

Returns all current Toyota vehicle models with basic specifications. Each vehicle includes series slug, display name, model year, category, base MSRP, fuel economy (city/highway/combined MPG), seating capacity, and a top label indicating powertrain type. No parameters required. The list covers the full Toyota lineup across all categories.

**Estimated cost:** Metered

_No parameters required._

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

### Get dealer locator

Finds Toyota dealerships near a given ZIP code sorted by proximity. Returns dealer name, full address, phone numbers, distance in miles, website URL, geographic coordinates, and detailed hours for sales, service, and parts departments. Up to 50 dealers returned per request.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zipcode` | string | Yes | 5-digit US ZIP code to search for nearby dealers |

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

### Get vehicle offers

Returns current promotional offers and financing deals for a specific Toyota model in a given ZIP code region. Includes lease, APR, cash back, military rebate, and college rebate offers. Each offer includes type, title, description, validity dates, and eligibility details. Results are grouped by TDA (Toyota Dealer Association) region.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series` | string | Yes | Vehicle series slug (e.g. 'camry', 'rav4', 'corolla') |
| `year` | string | Yes | Model year (e.g. '2025', '2026') |
| `zipcode` | string | No | 5-digit US ZIP code for location-based offers |

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

### Get vehicle trims

Returns detailed trim and grade information for a specific Toyota model and year. Each grade includes trim variants with MSRP, engine, transmission, fuel economy, horsepower, fuel type, and available exterior colors. Use the series slug from get_all_vehicles and a valid model year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series` | string | Yes | Vehicle series slug from get_all_vehicles (e.g. 'camry', '4runner', 'rav4', 'corolla') |
| `year` | string | Yes | Model year (e.g. '2025', '2026') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/toyota/get-vehicle-trims \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"series":"<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.