Objects & Availability API

Query bookable objects and check real-time availability for any date range.

Endpoints

GET

/tenants/{tenantId}/objects/availability

Check availability for objects in a date range

GET

/tenants/{tenantId}/objects/{objectId}/opening-hours

Get opening hours for an object

GET

/tenants/{tenantId}/objects/{objectId}/booking-rules

Get booking rules (duration, increment, etc.)

Check Availability

Returns available time slots for the specified objects and date range. Considers existing bookings, opening hours, special dates, and booking rules.

Query Parameters

Parameter	Type	Required	Description
`date`	YYYY-MM-DD	Yes	Date to check
`objectId`	uuid	No	Filter to specific object
`accommodationId`	uuid	No	Filter by accommodation

Example

Requestbash

curl -X GET \
  "https://your-domain.booqr.nl/api/v1/tenants/{tenantId}/objects/availability?date=2026-02-18" \
  -H "Authorization: Bearer booqr_your_api_key"

Response 200json

{
  "date": "2026-02-18",
  "objects": [
    {
      "objectId": "uuid",
      "objectName": "Court 1",
      "slots": [
        { "start": "07:00", "end": "08:00", "available": true },
        { "start": "08:00", "end": "09:00", "available": true },
        { "start": "09:00", "end": "10:00", "available": false },
        { "start": "10:00", "end": "11:00", "available": true }
      ]
    }
  ]
}

Opening Hours

Returns the weekly opening hours schedule and any special dates (holidays, events) that override the regular schedule.

Requestbash

curl -X GET \
  "https://your-domain.booqr.nl/api/v1/tenants/{tenantId}/objects/{objectId}/opening-hours" \
  -H "Authorization: Bearer booqr_your_api_key"

Response 200json

{
  "schedule": {
    "monday": { "open": "07:00", "close": "22:00" },
    "tuesday": { "open": "07:00", "close": "22:00" },
    "wednesday": { "open": "07:00", "close": "22:00" },
    "thursday": { "open": "07:00", "close": "22:00" },
    "friday": { "open": "07:00", "close": "23:00" },
    "saturday": { "open": "08:00", "close": "22:00" },
    "sunday": { "open": "08:00", "close": "20:00" }
  },
  "specialDates": [
    { "date": "2026-12-25", "closed": true, "reason": "Christmas" }
  ]
}