# Turo — 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 for peer-to-peer car rentals across Turo by location and dates to browse available vehicles with pricing, specifications, and real-time availability. Get detailed information on specific cars to compare features and make rental decisions.

**Category:** Travel | **Website:** [turo.com/](https://turo.com/) | **Docs:** [parse.bot/marketplace/d31134d9-7962-4ea1-a19e-77d726ca7ead/turo-com-api](https://parse.bot/marketplace/d31134d9-7962-4ea1-a19e-77d726ca7ead/turo-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/turo/`
**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 vehicle detail

Get detailed information about a specific vehicle including pricing, specs, features, host info, ratings, and images. Vehicle ID can be obtained from search_cars results. Provides trip-specific pricing when dates are supplied, plus full specifications, feature lists, and rating breakdowns not available in search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | Trip end date in YYYY-MM-DD format for pricing. Defaults to 10 days from now. |
| `end_time` | string | No | Return time in HH:MM format |
| `start_date` | string | No | Trip start date in YYYY-MM-DD format for pricing. Defaults to 7 days from now. |
| `start_time` | string | No | Pickup time in HH:MM format |
| `vehicle_id` | string | Yes | Turo vehicle ID (from search_cars results[*].id) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/turo/get-vehicle-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","end_time":"<string>","start_date":"<string>","start_time":"<string>","vehicle_id":"<string>"}'
```

### Search cars

Search for available rental cars on Turo by location, dates, and filters. Returns vehicle listings with pricing, ratings, and availability. Each vehicle summary exposes an id usable with get_vehicle_detail for full specs, features, and trip pricing. Server-side filtering covers location, vehicle type, make, and sort order; price filtering is applied client-side on the returned set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | Trip end date in YYYY-MM-DD format. Defaults to 10 days from now. |
| `end_time` | string | No | Return time in HH:MM format |
| `limit` | integer | No | Maximum number of results to return |
| `location` | string | No | City or location to search (e.g., 'Los Angeles', 'Miami, FL') |
| `make` | string | No | Filter by make (comma-separated): e.g., 'Tesla,BMW' |
| `max_price` | string | No | Maximum daily price filter (USD) |
| `min_price` | string | No | Minimum daily price filter (USD) |
| `sort_type` | string | No | Sort order for results |
| `start_date` | string | No | Trip start date in YYYY-MM-DD format. Defaults to 7 days from now. |
| `start_time` | string | No | Pickup time in HH:MM format |
| `vehicle_type` | string | No | Filter by vehicle type (comma-separated for multiple) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/turo/search-cars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","end_time":"<string>","limit":"<integer>","location":"<string>","make":"<string>","max_price":"<string>","min_price":"<string>","sort_type":"<string>","start_date":"<string>","start_time":"<string>","vehicle_type":"<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.