parking73 ops

Parking API

Parking lots, bookings, occupancy, providers, and session pricing.

Queries

QUERY

adminListParkingLots

#

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.

Arguments

  • statuses[!]
  • searchString
  • providerId
  • pagination
Returns!
QUERY

adminParkingBooking

#

Get a parking booking by ID (admin view).

Arguments

  • id!
Returns
QUERY

adminParkingLot

#

Get a parking lot by ID (admin view).

Arguments

  • id!
Returns
QUERY

adminParkingLotSetup

#

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.

Arguments

  • lotId!
Returns
QUERY

browseNearbyLots

#

Browse nearby parking lots.

Arguments

  • input!
  • pagination
Returns!
QUERY

cancellationPolicies

#

List all cancellation policies.

Arguments

  • pagination
Returns!
QUERY

durationOptions

#

List all duration options.

Arguments

  • pagination
Returns!
QUERY

myActiveBookings

#

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

Arguments

  • lotId
  • pagination
Returns!
QUERY

myBookingExtensions

#

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.

Arguments

  • bookingId!
Returns[!]!
QUERY

myBookingHistory

#

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

Arguments

  • filter
  • pagination
Returns!
QUERY

myBookingRequests

#

Get pending booking requests for the provider.

Arguments

  • filter
  • pagination
Returns!
QUERY

myEarnings

#

Get provider's earnings summary.

Returns!
QUERY

myExtensionRequests

#

Get pending extension requests for the provider.

Arguments

  • pagination
Returns!
QUERY

myLot

#

Get a specific lot's full details.

Arguments

  • lotId!
Returns!
QUERY

myLotBooking

#

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.

Arguments

  • bookingId!
Returns!
QUERY

myLots

#

Get the provider's parking lots.

Arguments

  • pagination
Returns!
QUERY

myParkingBooking

#

Get a specific booking by ID.

Arguments

  • bookingId!
Returns!
QUERY

myParkingBookings

#

Get the current user's bookings.

Arguments

  • filter
  • pagination
Returns!
QUERY

myParkingCustomerMetrics

#

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.

Returns!
QUERY

myPerformanceMetrics

#

Get provider's performance metrics.

Returns!
QUERY

myRecentParkingLots

#

The active lots the caller has booked, each once, the one booked most recently first — whatever became of the booking.

Arguments

  • input!
  • pagination
Returns!
QUERY

parkingBookingQuote

#

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.

Returns!
QUERY

parkingBookingSettings

#

The workspace's booking settings, for the parking settings page.

Returns!
QUERY

parkingFeatures

#

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.

Arguments

  • pagination
Returns!
QUERY

parkingLotById

#

Get parking lot details by ID.

Arguments

  • lotId!
Returns!
QUERY

parkingProvider

#

Get a parking provider by ID.

Arguments

  • id!
Returns
QUERY

parkingProviders

#

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.

Arguments

  • status[!]
  • searchString
  • pagination
Returns!
QUERY

parkingVehicleImagePacks

#

Every pack of the vehicle catalog with each vehicle drawn in it, the workspace's own marked, for the parking settings page.

Returns[!]!
QUERY

parkingVehicleImages

#

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.

Returns[!]!
QUERY

tenantParkingFeatures

#

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.

Returns[!]!

Mutations

MUTATION

acceptBooking

#

Accept a booking request.

Arguments

  • bookingId!
Returns!
MUTATION

acceptExtension

#

Accept an extension request.

Arguments

  • extensionId!
Returns!
MUTATION

adminGrantParkingLotBadge

#

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.

Arguments

  • input!
Returns!
MUTATION

adminRevokeParkingLotBadge

#

Take a badge away from a lot. Taking away one it does not hold is not an error: the lot ends up without it either way.

Arguments

  • input!
Returns!
MUTATION

approveParkingLot

#

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.

Arguments

  • lotId!
Returns!
MUTATION

approveParkingProvider

#

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.

Arguments

  • providerId!
Returns!
MUTATION

cancelParkingBooking

#

Cancel a parking booking.

Arguments

  • input!
Returns!
MUTATION

confirmParkingBooking3ds

#

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.

Arguments

  • input!
Returns!
MUTATION

confirmParkingBookingPayment

#

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).

Arguments

  • input!
Returns!
MUTATION

confirmParkingExtension3ds

#

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.

Arguments

  • input!
Returns!
MUTATION

createCancellationPolicy

#

Create a new cancellation policy.

Arguments

  • input!
Returns!
MUTATION

createDurationOption

#

Create a new duration option.

Arguments

  • input!
Returns!
MUTATION

createParkingBooking

#

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.

Arguments

  • input!
Returns!
MUTATION

createParkingFeature

#

Create a new global parking feature.

Arguments

  • input!
Returns!
MUTATION

createParkingLot

#

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.

Arguments

  • input!
Returns!
MUTATION

deleteCancellationPolicy

#

Delete a cancellation policy.

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteDurationOption

#

Delete a duration option.

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteParkingFeature

#

Delete a parking feature.

Arguments

  • id!
ReturnsBoolean!
MUTATION

markNoShow

#

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.

Arguments

  • bookingId!
Returns!
MUTATION

payParkingExtension

#

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.

Arguments

  • input!
Returns!
MUTATION

recordEntry

#

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

Arguments

  • bookingId!
Returns!
MUTATION

recordExit

#

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

Arguments

  • bookingId!
Returns!
MUTATION

registerParkingProvider

#

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.

Arguments

  • input!
Returns!
MUTATION

rejectBooking

#

Reject a booking request.

Arguments

  • input!
Returns!
MUTATION

rejectExtension

#

Reject an extension request.

Arguments

  • input!
Returns!
MUTATION

rejectParkingLot

#

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.

Arguments

  • input!
Returns!
MUTATION

rejectParkingProvider

#

Reject a parking provider application.

Arguments

  • input!
Returns!
MUTATION

requestParkingExtension

#

Request an extension for an active booking.

Arguments

  • input!
Returns!
MUTATION

setLotCapacity

#

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

Arguments

  • input!
Returns[!]!
MUTATION

setLotFeatures

#

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

Arguments

  • input!
Returns[!]!
MUTATION

setLotHours

#

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

Arguments

  • input!
Returns[!]!
MUTATION

setLotRates

#

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

Arguments

  • input!
Returns[!]!
MUTATION

setParkingCashPayments

#

Lets car owners choose to pay at the lot, in cash, when they reserve — or stops them — for bookings made from now on. Returns the switch as saved.

Arguments

  • enabledBoolean!
ReturnsBoolean!
MUTATION

setParkingPaymentWindow

#

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.

Arguments

  • minutesInt!
ReturnsInt!
MUTATION

setParkingVehicleImagePack

#

Draws the workspace's vehicles in pack from now on, in every parking app. Returns the pack as saved.

Arguments

  • pack!
Returns!
MUTATION

submitParkingReview

#

Submit a review for a completed booking.

Arguments

  • input!
Returns!
MUTATION

suspendParkingProvider

#

Suspend an approved parking provider. Their lots stop taking bookings (bookings already made are unaffected) until unsuspendParkingProvider. reason is required.

Arguments

  • input!
Returns!
MUTATION

unsuspendParkingProvider

#

Lift a provider's suspension, returning them to approved and clearing the suspension reason.

Arguments

  • providerId!
Returns!
MUTATION

updateCancellationPolicy

#

Update an existing cancellation policy.

Arguments

  • input!
Returns!
MUTATION

updateDurationOption

#

Update an existing duration option.

Arguments

  • input!
Returns!
MUTATION

updateParkingFeature

#

Update an existing parking feature.

Arguments

  • input!
Returns!
MUTATION

updateParkingLot

#

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.

Arguments

  • input!
Returns!

Subscriptions

SUBSCRIPTION

parkingUserEvents

#

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!