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

> 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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```