canonical: https://jentic.com/apis/parkwhiz.com/parkwhiz

# ParkWhiz Partner API

ParkWhiz Partner API v4 provides comprehensive parking search, booking, and account management for reservable parking facilities. The API enables parking availability search by location, event, or venue with date/time filters, location and quote retrieval with pricing, booking creation and management with previews and cancellations, parking pass retrieval, account registration and profile management, vehicle management, review submission and retrieval, and support ticket operations. OAuth 2.0 authentication supports multiple grant flows including client credentials, password, authorization code, and refresh token.

## For AI agents

Search parking availability, create bookings, manage accounts and vehicles, and handle reviews for reservable parking facilities.

## Scope

Does not control physical parking access or provide real-time occupancy - use only for booking reservable parking facilities with advance confirmation.

## Capabilities

- Search parking quotes by location coordinates, event, venue, or address with date/time parameters
- Retrieve parking facility details with amenities, restrictions, and pricing
- Preview booking pricing and create, cancel, and retrieve parking bookings
- Retrieve parking passes with QR codes and entry instructions
- Register user accounts and manage profile information
- Add, update, delete, and retrieve vehicles associated with accounts
- Submit and retrieve facility reviews with ratings
- Create and manage support tickets for booking issues

## Use cases

### Event Parking Discovery and Booking

Integrate ParkWhiz into event ticketing or venue apps. GET /quotes?event_id={id}&start={time}&end={time} returns available parking with pricing sorted by distance. Users select a quote, POST `/bookings/previews` to see final pricing, then POST /bookings to complete the reservation. GET `/bookings/{id}/parking_pass` retrieves the digital pass with entry instructions.

Example prompt: GET /quotes with event_id or lat/lng, start, and end times. Preview with POST `/bookings/previews`, then POST /bookings to confirm. Retrieve pass with GET `/bookings/{booking_id}/parking_pass.`

### Travel Planning with Parking

Add parking search to travel or navigation apps. GET /quotes by destination coordinates and travel dates returns nearby facilities with rates. Users book in advance to guarantee a spot and avoid circling. Vehicle information from GET `/accounts/me/vehicles` pre-fills booking forms.

Example prompt: GET /quotes?lat={lat}&lng={lng}&start={ISO8601}&end={ISO8601}, then POST /bookings with the selected quote ID and vehicle. Manage vehicles via GET/POST `/accounts/me/vehicles.`

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/quotes` | Search parking availability and pricing |
| GET | `/locations/{location_id}` | Get parking facility details |
| POST | `/bookings` | Create a new parking booking |
| POST | `/bookings/previews` | Preview booking pricing before confirmation |
| DELETE | `/bookings/{booking_id}` | Cancel a parking booking |
| GET | `/bookings/{booking_id}/parking_pass` | Retrieve parking pass for a booking |
| POST | `/accounts` | Register a new user account |
| GET | `/accounts/me/vehicles` | List user vehicles |
| POST | `/locations/{location_id}/reviews` | Submit a facility review |

## Key resources

- **Quotes** — Parking availability and pricing for locations, events, or venues
- **Locations** — Parking facilities with addresses, amenities, restrictions, and reviews
- **Bookings** — Parking reservations with confirmation details and parking passes
- **Accounts** — User profiles with email, phone, and payment methods
- **Vehicles** — User vehicles with license plates, make, model, and color
- **Reviews** — Facility ratings and review text from users

## Why Jentic

- **Setup:** Wiring the ParkWhiz Partner API by hand means running its OAuth2 client-credentials flow, refreshing tokens, choosing production or sandbox host, and shaping the quote and booking routes yourself. Through Jentic you install once, import ParkWhiz from the API Directory, store the client credentials once, and your agent calls it.
- **Permission scoping:** ParkWhiz puts the location id and booking id in the URL path (`/locations/{location_id}`, `/bookings/{booking_id}`), so a rule can pin your agent to one location or booking: it can fetch quotes and read a parking pass. You choose the operations it may call, so booking cancellation is not included unless you add it.
- **Credential handling:** Your ParkWhiz client credentials are stored once, encrypted, by your own Jentic One instance, and tokens are refreshed and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'book parking near a venue' or 'get a parking quote', and Jentic returns the matching ParkWhiz operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **ParkMobile API** — ParkMobile handles on-street metered parking while ParkWhiz focuses on reservable garage and lot parking.

## FAQ

### What authentication does the ParkWhiz API use?

The API uses OAuth 2.0 with multiple grant flows: client_credentials for server-to-server, password for user login, authorization_code for web flows, and refresh_token for token renewal. Jentic manages OAuth token refresh automatically.

### Can I preview booking pricing before confirming?

Yes. POST `/bookings/previews` with the quote ID and booking details returns the final price including fees and taxes before you POST /bookings to confirm.

### How do I retrieve a parking pass after booking?

Use GET `/bookings/{booking_id}/parking_pass` to retrieve the pass with QR code, entry instructions, and facility contact information.

### Can I limit what my agent is allowed to do with the ParkWhiz Partner API?

Yes. Because Jentic One is self-hosted, your own rules decide which ParkWhiz operations and credentials the agent may use. ParkWhiz puts the location id and booking id in the URL path (`/locations/{location_id}`, `/bookings/{booking_id}`), so a rule can pin your agent to a single location or booking and let it only fetch quotes with GET /quotes and read a parking pass with GET `/bookings/{booking_id}/parking_pass.` You choose the operations it may call, so booking cancellation with DELETE `/bookings/{booking_id}` is excluded unless you add it.