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

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-toyota-com-api-7b35dbaf/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-toyota-com-api-7b35dbaf/get_all_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-toyota-com-api-7b35dbaf/get_dealer_locator \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-toyota-com-api-7b35dbaf/get_vehicle_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-toyota-com-api-7b35dbaf/get_vehicle_trims \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"series":"<string>","year":"<string>"}'
```