Parking API

List all parking bookings (admin view). When statuses is provided the server filters in-DB; omitting it returns every booking.

List all parking lots (admin view). statuses and search (case-insensitive substring on name/address/slug) are applied in-DB; both default to "no filter" when omitted.

Get a parking booking by ID (admin view).

Get a parking lot by ID (admin view).

Roll-up counters for the parking admin overview dashboard. Revenue is filtered by currency; bookings/lots/customers are tenant-wide.

Browse nearby parking lots.

List all cancellation policies.

Get a cancellation policy by ID.

Get a duration option by ID.

List all duration options.

Get the current provider's profile.

Get active (confirmed/in-progress) bookings for the provider.

List the extensions for one of the caller's bookings, most recent first. Ownership-checked: the booking must belong to the calling account. This is how a client discovers a provider-approved extension (status Approved = awaiting payment) so it can charge it via payParkingExtension — read id to pass to the mutation, status to know whether it is awaiting payment vs Paid/Pending/Rejected/Expired, and additionalPrice to show the amount.

Get booking history (past/completed bookings) for the provider.

Get pending booking requests for the provider.

Get provider's earnings summary.

Get pending extension requests for the provider.

Get a specific lot's full details.

Get the provider's parking lots.

Get a specific booking by ID.

Get a booking by its code.

Get the current user's bookings.

Get provider's performance metrics.

Quote the total price of a prospective parking booking without creating it. Returns the base rate, service fee, tax, and grand total the customer would be charged for the given lot, duration option, and vehicle — identical to what createParkingBooking charges for the same inputs. Read-only: it holds no capacity and creates no booking.

Get a parking feature by ID.

List all parking features. Paginated admin surface — limited to TenantAdmin (for their own tenant) and PlatformAdmin. Regular authenticated users that previously hit this endpoint must migrate to the public surface (per-lot feature lists or the upcoming public catalog query); the bare admin endpoint must not be reachable from client apps.

Get parking lot details by ID.

Get parking lot details by slug.

Get a parking provider by ID.

List all parking providers.

Service health check query.

Public catalog of enabled parking features for the current tenant — drives the filter sheet and the "add spot" facility picker in the client app. Returns the full list (no pagination) since these UIs render every option inline. The paginated admin endpoint (parkingFeatures) is role- guarded; this is the sibling clients call instead.

Accept a booking request.

Accept an extension request.

Approve a parking provider application.

Cancel a parking booking.

Confirm a parking booking's payment after the customer completes client-side authentication (3DS) for the initial authorization. Called when the initial confirmParkingBookingPayment returned a paymentObject requiring action and left the booking in PaymentPending. On a successful hold the booking transitions PaymentPending -> Confirmed with paymentStatus = Authorized (funds held; captured later at exit). If the payment still requires action, the booking stays PaymentPending and a fresh paymentObject is returned.

Confirm payment for an approved parking booking. This authorizes (holds) the payment amount on the customer's payment method. The booking status changes from Approved to Confirmed (or PaymentPending if 3DS required). The payment is captured later when the booking is completed (vehicle exits).

Confirm a parking extension's payment after the customer completes client-side authentication (3DS) for the initial authorization. Called when payParkingExtension returned a paymentObject requiring action and left the extension Approved with a stored payment attempt. On a successful hold the extension is applied (Approved -> Paid, booking extended, order total synced). If it still requires action, the extension stays Approved and a fresh paymentObject is returned.

Create a new cancellation policy.

Create a new duration option.

Create a new parking booking request. Tenant admins may pass customerId in the input to dispatch on behalf of another account; non-admin callers always book for themselves.

Create a new global parking feature.

Create a new parking lot. Tenant admins may pass providerId in the input to create the lot under another provider; non-admin callers always create under their own provider.

Delete a cancellation policy.

Delete a duration option.

Delete a parking feature.

Mark a confirmed booking as no-show. This can be called when the customer didn't arrive within the allowed grace period after the scheduled start time.

Service health check mutation.

Pay for a provider-approved parking booking extension. Authorizes (holds) the extension charge (parking rate + service fee + tax) on the customer's payment method. On an immediate hold the extension is applied: the booking's end time and total grow, the parent order total is synced, and the extension moves Approved -> Paid. If the PSP requires 3DS, a paymentObject is returned and the extension stays Approved so the client can finish via confirmParkingExtension3ds.

Record vehicle entry for a confirmed booking. This transitions the booking from Confirmed to InProgress status and records the actual entry time.

Record vehicle exit for an in-progress booking. This transitions the booking from InProgress to Completed status and records the actual exit time.

Register as a parking provider. Tenant admins may pass accountId in the input to register on behalf of another account; non-admin callers always register themselves regardless of the override.

Reject a booking request.

Reject an extension request.

Reject a parking provider application.

Request an extension for an active booking.

Set lot capacity by vehicle type. Authorization: provider owner or tenant admin.

Set lot features. Authorization: provider owner or tenant admin.

Set lot operating hours. Authorization: provider owner or tenant admin.

Set lot rates. Authorization: provider owner or tenant admin.

Submit a review for a completed booking.

Update an existing cancellation policy.

Update an existing duration option.

Update an existing parking feature.

Update a parking lot. Tenant admins can update any lot in the tenant; providers can only update their own.

Subscribe to parking user events (Parking service) Receive real-time events relevant to parking users: - Reservation confirmations - Session updates - Expiry warnings - Notifications **Requirements:** - Must be authenticated - Must have Customer role - Must be using Parking app