For Agents
Manage parking spot reservations, track changes, and retrieve occupancy reports for Parkalot parking facilities.
Use for: I need to reserve a parking spot for a user next week, Check if any reservations changed in the last hour, Get a report of all parking occupancy for today, Release all reservations for a specific user
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Parkalot API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Parkalot API.
Retrieve parking reservations in nested (grouped by day/item) or flat (one period per record) formats
Create or release parking spot reservations in batch operations with waitlist support
Delete user reservations across date ranges (max 31 days) by uid, externalId, or email
GET STARTED
Not supported: Does not control physical access gates, process payments, or manage facility setup — use only for reservation queries, batch reservation updates, deletion, change detection, and occupancy reporting.
Parkalot API provides parking reservation management and reporting for facilities, enabling operators to query reservations in flat or nested formats, create and release parking spot reservations in batch, delete reservations for date ranges, track reservation changes via timestamp comparison, and retrieve parking reports with item-level occupancy details. Authentication uses a scoped API key with permissions for reports, reservations, users, and setup operations.
Check if reservations or parking setup changed since a given unix timestamp
Query parking reports showing item state, user assignments, and reservation timing
Include optional item metadata: tags, descriptions, group IDs, and group names
Patterns agents use Parkalot API for, with concrete tasks.
★ Automated Reservation Management
Integrate Parkalot reservations into an office management or visitor scheduling system. PUT /reservations/{facilityId} accepts a batch array where each entry specifies spot, day, shifts, and uid (null to unreserve). Use externalId or email to map users between systems, and withWaitlist to trigger automatic assignment when spots free up.
PUT /reservations/{facilityId} with an array of PublicReserveRequest objects. Set uid to the user identifier to reserve, or null to unreserve. Check the ReserveResponse array for per-request success or error.
Real-Time Reservation Monitoring
Poll for reservation changes to drive real-time dashboards or notification workflows. GET /reservations/{facilityId}/did-change/{fromDay}/{toDay}?since={timestamp} returns hasChanges and per-day change flags, allowing efficient incremental syncs without fetching full data when nothing changed.
GET /reservations/{facilityId}/did-change/{fromDay}/{toDay}?since={lastSyncTimestamp} and only re-fetch reservations if hasChanges is true or a specific day's changed flag is set.
Occupancy Reporting
Generate parking occupancy reports for compliance, billing, or analytics by querying the reports endpoint. GET /reports/{facilityId}/readable/{fromDay}/{toDay} returns item-level records with user assignments, reservation/release timestamps, and owner information. Use for weekly summaries, chargebacks, or identifying underutilized spots.
GET /reports/{facilityId}/readable/{fromDay}/{toDay} and parse the items array. Each ItemState record includes item name, user name, reserved_at, released_at, and group membership.
5 endpoints — parkalot api provides parking reservation management and reporting for facilities, enabling operators to query reservations in flat or nested formats, create and release parking spot reservations in batch, delete reservations for date ranges, track reservation changes via timestamp comparison, and retrieve parking reports with item-level occupancy details.
METHOD
PATH
DESCRIPTION
/reservations/{facilityId}/nested-day/{fromDay}/{toDay}
Query reservations in nested format grouped by day and item
/reservations/{facilityId}/flat/{fromDay}/{toDay}
Query reservations in flat format with one time period per record
/reservations/{facilityId}
Create or release parking spot reservations in batch
/reservations/{facilityId}/{fromDay}/{toDay}
Delete user reservations for a date range
/reports/{facilityId}/readable/{fromDay}/{toDay}
Retrieve parking occupancy reports
/reservations/{facilityId}/nested-day/{fromDay}/{toDay}
Query reservations in nested format grouped by day and item
/reservations/{facilityId}/flat/{fromDay}/{toDay}
Query reservations in flat format with one time period per record
/reservations/{facilityId}
Create or release parking spot reservations in batch
/reservations/{facilityId}/{fromDay}/{toDay}
Delete user reservations for a date range
/reports/{facilityId}/readable/{fromDay}/{toDay}
Retrieve parking occupancy reports
Three things that make agents converge on Jentic-routed access.
Credential isolation
Parkalot API keys are stored encrypted in Jentic's vault and injected as the x-api-key header at execution time. Raw keys never appear in agent prompts or logs.
Intent-based discovery
Agents search by intent such as 'reserve a parking spot parkalot' or 'get parking occupancy report' and Jentic returns the matching endpoint with its schema and example requests.
Time to first call
Direct Parkalot integration: 1-2 days to model reservations, reports, and batch operations. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Parkalot API through Jentic.
What authentication does the Parkalot API use?
The API uses API key authentication via the x-api-key header with scoped permissions: reports-exact-read, reservations-read, reservations-write, users-read, users-write, setup-read, setup-write, spots-read, spots-write, access-write, confirmation-settings-read/write, and integrations-settings-read/write. Jentic stores the key encrypted and injects it at execution time.
What is the maximum date range for reservations?
Reservation queries and deletions support a maximum 31-day range between fromDay and toDay. The API returns 400 Bad Request if the range exceeds this limit.
Can I trigger waitlist processing when releasing a spot?
Yes. Set withWaitlist=true in the PublicReserveRequest or as a query parameter on DELETE operations. This triggers automatic assignment from the waitlist when a spot becomes available.
How do I check for reservation changes without fetching all data?
Use GET /reservations/{facilityId}/did-change/{fromDay}/{toDay}?since={unixTimestampInMillis}. It returns hasChanges and a per-day array of change flags, allowing incremental syncs.