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

> Search new and used car inventory on Edmunds by make, model, year, condition, and location. Retrieve detailed specs, pricing, history, and dealer info by VIN, and browse all available car makes.

**Category:** Automotive | **Website:** [edmunds.com/](https://edmunds.com/) | **Docs:** [parse.bot/marketplace/6d4b8554-8e2c-451c-8323-047069e787b9/edmunds-com-api](https://parse.bot/marketplace/6d4b8554-8e2c-451c-8323-047069e787b9/edmunds-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/edmunds/`
**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 makes

Retrieves the full list of car makes available in Edmunds used car inventory. Each make includes a display name and a URL-friendly slug (niceName). The list includes both current and discontinued brands (69 total). No pagination or filtering — returns all makes in a single response.

**Estimated cost:** Metered

_No parameters required._

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

### Get vehicle details

Get detailed information for a specific vehicle listing by its VIN. Returns pricing, specs, vehicle history, and dealer information. Searches across used, new, and CPO inventory. Returns input_not_found if the VIN is not currently listed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vin` | string | Yes | 17-character Vehicle Identification Number. |

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

### Search inventory

Search for used or new car inventory on Edmunds based on make, model, year, condition, and location. Returns up to 21 listings per request. Each listing includes VIN, pricing, mileage, vehicle specs, dealer info, deal rating, and vehicle history. Results are sorted by Edmunds boost algorithm by default.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `condition` | string | No | Vehicle condition: used or new. |
| `make` | string | No | Car make niceName slug (e.g. honda, toyota, bmw). Use values from get_makes endpoint. |
| `model` | string | No | Car model niceName slug (e.g. civic, camry, 3-series). |
| `year` | string | No | Model year (e.g. 2020, 2021). |
| `zip` | string | No | 5-digit US ZIP code for location-based search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/edmunds/search-inventory \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"condition":"<string>","make":"<string>","model":"<string>","year":"<string>","zip":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.