API Documentation

Use the endpoints below to fetch live parking availability from the TU Delft campus data feed.

Base API URL: https://parkeerbeheer.smaas.nl

The cache refresh interval is 30 seconds, and the low-availability warning is triggered when a garage drops below 1000 available spaces.

Back to homepage

All garages

GET /api/

Returns a JSON object with availability for all garages (P1–P6).

Single garage

GET /api/<code>

Returns JSON for one garage. The code is case-insensitive.

Example: /api/p5

Plain-text spoken sentence

GET /api/speak/<lang>/<code>

Returns a plain-text sentence suitable for reading aloud. lang is en (English) or nl (Dutch).

If the garage has fewer than 1000 available spaces, two suggested alternative garages are appended.

Examples:

• /api/speak/en/p5 → P5 has 426 available parking spaces.
• /api/speak/nl/p5 → P5 heeft 426 beschikbare parkeerplaatsen.
• Low availability → P5 has 12 available parking spaces. Consider: P1 (91 spaces), P2 (441 spaces).

Apple Automation — Speak over Bluetooth speakers

You can use an Apple Shortcut (iOS / macOS) to automatically fetch and speak the availability of your preferred garage over a Bluetooth speaker whenever you want — for example when you connect to your car or arrive on campus.

Step-by-step (iPhone / iPad)

1. Open the Shortcuts app.
2. Tap + to create a new shortcut.
3. Add the action “Get contents of URL”.
   Set the URL to:
   https://parkeerbeheer.smaas.nl/api/speak/nl/p5
   (replace nl / p5 with your preferred language and garage.)
4. Add the action “Speak Text”.
   Set the input to the result of the previous step (Contents of URL).
5. Optionally tap “Show more” on the Speak Text action to choose a language/voice that matches your chosen language code.
6. Name the shortcut, e.g. “Parking P5”, and save.

Trigger automatically

To run the shortcut automatically over Bluetooth speakers:

1. In the Shortcuts app go to the Automation tab.
2. Tap + → Personal Automation.
3. Choose a trigger, for example:
   • Bluetooth → connects to → your car or speaker
   • Time of Day → weekdays at 08:30
   • Arrive → at TU Delft campus location
4. Add the action “Run Shortcut” and select the shortcut you created above.
5. Disable “Ask before running” so it executes silently.
6. Save the automation.

The next time the trigger fires your device will fetch live parking data and speak it aloud over the connected Bluetooth speaker.

This is just a proof of concept. Contact: sebasfm -a- gmail dot com