List all parking lots (admin view). statuses, search
(case-insensitive substring on name/address/slug) and providerId
(one provider's lots) are applied in-DB; each defaults to "no filter"
when omitted.
A lot's full setup for editing (admin view): the lot in any status
with every capacity, feature, rate and opening-hours row, including
disabled and future-dated entries the customer read leaves out.
null when the lot is not in the caller's tenant.
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.
One booking at one of the caller's lots, in full — what the owner
opens from their sessions and requests. A booking at another
provider's lot is not found.
Get the calling customer's own parking KPIs.
Unlike myPerformanceMetrics this needs no provider row, so it works
for any authenticated account — a customer with no bookings yet gets
zeroes and a null rating rather than a not-found error.
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.
Arguments
lotId!
durationOptionId!
vehicleType!
vehicleSize
couponCodeString
Optional promotion coupon code to preview. When present and valid, `total` reflects the discount and `discount` is populated; otherwise `couponError` explains why it wasn't applied.
List all parking features. Paginated admin surface — limited to
admin-tier sessions (owner, tenant admin, platform admin). 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.
List parking providers, newest first. status keeps only providers
in one of those statuses and search is a case-insensitive substring
match on business name, contact email and contact phone; both default
to "no filter" when omitted or empty.
The picture of each vehicle a booking can be for — a car of each size,
a motorcycle, a truck — in the pack the workspace chose. The apps show
it in the middle of an active booking's countdown.
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.
Grant a lot a badge, for a set time or with no end. While FEATURED
shows, the lot is listed ahead of the others in a search.
A lot holds at most one badge of each kind, so granting one it already
holds moves that badge's window instead of adding a second. Admin-tier
sessions only; config-locked accounts get CONFIG_LOCKED. A window
that ends before it starts, or has already ended, fails with
VALIDATION_ERROR.
Approve a lot awaiting review (PENDING_APPROVAL → ACTIVE).
Stamps reviewedAt and clears rejectionReason. Admin-tier sessions
only; config-locked accounts get CONFIG_LOCKED. A lot in any other
status fails with INVALID_STATUS_TRANSITION, and a lot whose provider
is not approved (KYC pending, suspended, ...) with
PROVIDER_NOT_APPROVED.
Approve a parking provider application — from PENDING or
KYC_PENDING (a no-op on an approved provider). Also approves the
provider's pending KYC application, if there is one.
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 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 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.
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.
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.
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 lot awaiting review (PENDING_APPROVAL → ARCHIVED).
Stores reason as rejectionReason and stamps reviewedAt; the
provider can fix the lot and resubmit it. Admin-tier sessions only;
config-locked accounts get CONFIG_LOCKED. A blank reason fails with
VALIDATION_ERROR, a lot not awaiting review with
INVALID_STATUS_TRANSITION.
Gives car owners minutes to pay once a lot accepts their booking,
for bookings accepted from now on (those already accepted keep their
deadline). Between 5 and 1440. Returns the window as saved.
Suspend an approved parking provider. Their lots stop taking bookings
(bookings already made are unaffected) until
unsuspendParkingProvider. reason is required.
Update a parking lot. Tenant admins can update any lot in the
tenant, whatever its provider's state, except that taking a non-live
lot to ACTIVE (an approval) needs an approved provider
(PROVIDER_NOT_APPROVED). Providers can only update their own, and
only while approved.
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
Returns!
Build the foundation once. Expand without limits.
BetterSuite is built for teams who see on-demand as a business — not a feature.