# Carvana — 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 Carvana's used car inventory by make, model, price, fuel type, and more. Retrieve paginated listings with pricing, specs, and delivery details, or fetch comprehensive information for a specific vehicle by ID.

**Category:** Automotive | **Website:** [carvana.com/](https://carvana.com/) | **Docs:** [parse.bot/marketplace/840a2a5b-0233-4802-bf08-3fdf894e7058/carvana-com-api](https://parse.bot/marketplace/840a2a5b-0233-4802-bf08-3fdf894e7058/carvana-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-carvana-com-api-840a2a5b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cheapest_electric_vehicles

Fetch electric vehicles sorted by lowest price. Returns paginated results from the cheapest electric vehicles available on Carvana. Equivalent to search_electric_vehicles with sort_by=LowestPrice.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip5` | string | No | 5-digit US ZIP code for local results and shipping calculation. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carvana-com-api-840a2a5b/get_cheapest_electric_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip5":"<string>"}'
```

### get_vehicle_detail

Get detailed information for a specific vehicle by its Carvana vehicle ID. Returns comprehensive data including full specifications, features, condition, images, imperfections, warranty info, availability, and pricing. The vehicle ID is a numeric string found in search results (vehicleId field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vehicle_id` | string | Yes | Unique Carvana vehicle ID (numeric string from search results vehicleId field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carvana-com-api-840a2a5b/get_vehicle_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vehicle_id":"<string>"}'
```

### search_electric_vehicles

Search specifically for electric vehicles on Carvana. Automatically applies the Electric fuel type filter. Supports filtering by make and price range. Returns paginated results with same structure as search_vehicles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | No | Vehicle make (e.g., Tesla, Nissan, Chevrolet). |
| `max_price` | integer | No | Maximum price in USD. |
| `min_price` | integer | No | Minimum price in USD. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carvana-com-api-840a2a5b/search_electric_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","max_price":"<integer>","min_price":"<integer>","sort_by":"<string>"}'
```

### search_vehicles

Search for vehicles on Carvana with various filters and sorting options. Returns paginated results including vehicle details, pricing, financing info, and delivery information. Filters can be combined: make, model, fuel type, price range. Pagination via page number; default page size is 24.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fuel_type` | string | No | Fuel type filter (e.g., Electric, Hybrid, Gas). |
| `make` | string | No | Vehicle make (e.g., Tesla, Ford, Toyota). |
| `max_price` | integer | No | Maximum price in USD. |
| `min_price` | integer | No | Minimum price in USD. |
| `model` | string | No | Vehicle model (requires make to be set). |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | No | General search query keyword. |
| `sort_by` | string | No | Sort order for results. |
| `zip5` | string | No | 5-digit US ZIP code for local results and shipping calculation. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carvana-com-api-840a2a5b/search_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fuel_type":"<string>","make":"<string>","max_price":"<integer>","min_price":"<integer>","model":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>","sort_by":"<string>","zip5":"<string>"}'
```