# Bestparking — 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 for available parking spots across cities, view detailed lot information including pricing and availability, use location autocomplete to quickly find parking near any destination, and see which cities are supported.

**Category:** Maps & Geospatial | **Website:** [bestparking.com/](https://bestparking.com/) | **Docs:** [parse.bot/marketplace/e01637b3-6d29-4a77-bc22-74ce6ea9d83b/bestparking-com-api](https://parse.bot/marketplace/e01637b3-6d29-4a77-bc22-74ce6ea9d83b/bestparking-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/bestparking/`
**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

### Autocomplete locations

Get location suggestions and upcoming events based on a search term. Returns autocomplete results for cities, addresses, venues, and landmarks, plus relevant events with venue info and timing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term (e.g. city name, address, venue, landmark). |

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

### Get parking lot details

Get detailed information and pricing quotes for a specific parking lot. When start_time and end_time are provided, returns quotes with pricing for that time range (response is an array of quote objects with embedded location). Without times, returns static location details only (name, address, description, rating, photos, hours). The location_id comes from search_parking results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_time` | string | No | End time for the parking quote in ISO 8601 format (e.g. 2026-06-12T14:00:00Z). |
| `location_id` | string | Yes | Unique identifier for the parking lot (from search_parking results, e.g. '52007'). |
| `start_time` | string | No | Start time for the parking quote in ISO 8601 format (e.g. 2026-06-12T10:00:00Z). |

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

### Get supported cities

Retrieve a list of major cities supported by BestParking with their coordinates and URL slugs. Returns a static curated list.

**Estimated cost:** Metered

_No parameters required._

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

### Search parking

Search for parking locations (hourly or monthly) near a specific coordinate. Returns detailed pricing, availability, and curated recommendations (cheapest, closest). When start_time and end_time are omitted, defaults to a 2-hour window starting now. Each result includes full location info, pricing segments, amenities, and booking options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_time` | string | No | End time for the parking quote in ISO 8601 format (e.g. 2026-06-12T12:00:00). Defaults to 2 hours after start_time if omitted. |
| `lat` | number | Yes | Latitude of the search center. |
| `lng` | number | Yes | Longitude of the search center. |
| `search_type` | string | No | Type of search: 'transient' (hourly/daily) or 'monthly'. |
| `start_time` | string | No | Start time for the parking quote in ISO 8601 format (e.g. 2026-06-12T10:00:00). Defaults to current hour if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bestparking/search-parking \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_time":"<string>","lat":"<number>","lng":"<number>","search_type":"<string>","start_time":"<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.