Getting Started

Make your first API request in under 5 minutes. This guide walks you through creating an API key and fetching your bookings.

Step 1: Create an API Key

Navigate to Admin → API Keys in your dashboard and click “Create API Key”. Give it a descriptive name (e.g., “My Integration”) and select the scopes you need.

Copy the key immediately — it will only be shown once. The key starts with booqr_ followed by a random string.

Step 2: Make Your First Request

Use your API key to fetch your bookings. Include the key in the Authorization header as a Bearer token.

curl -X GET \
  "https://your-domain.booqr.nl/api/v1/tenants/{tenantId}/bookings" \
  -H "Authorization: Bearer booqr_your_api_key" \
  -H "Content-Type: application/json"

{
  "bookings": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "objectId": "...",
      "guestName": "Jan de Vries",
      "guestEmail": "jan@example.com",
      "startTime": "2026-02-17T10:00:00Z",
      "endTime": "2026-02-17T11:00:00Z",
      "status": "CONFIRMED",
      "totalPrice": 2500,
      "currency": "EUR"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 1
  }
}

Step 3: Explore the API

Now that you've made your first request, explore the full API reference:

• Bookings — Create and manage reservations
• Objects & Availability — Check availability and manage bookable objects
• Devices & Doors — IoT device management and door control
• Webhooks — Get real-time event notifications

Authentication Methods

BOOQR supports two authentication methods:

Rate Limits

API requests are rate limited per API key. The default limit is 100 requests per minute. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1708100000