Booking Suggestions

Returns AI-generated booking pattern suggestions for the authenticated customer.

GET /api/public/bookings/suggestions

Booking Suggestions

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/public/bookings/suggestions \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/bookings/suggestions"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/public/bookings/suggestions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Booking Suggestions

Returns personalised booking suggestions based on the customer’s historical usage patterns. Used to offer smart re-booking options on the dashboard.

Authentication

Requires a valid customer bearer token.

Query Parameters

_shape · string

Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation.

Response

Returns a BookingSuggestions object containing an array of suggested bookings based on the customer’s usage patterns.

Top-Level Fields

Field	Type	Description
Suggestions	object[]	Array of booking suggestion objects

Suggestion Fields (BookingDrop)

Identity

Field	Type	Description
Id	number	Unique numeric identifier for the booking
UniqueId	string	Globally unique identifier

Resource

Field	Type	Description
ResourceName	string	Resource display name
ResourceId	number	Resource identifier
ResourceTypeName	string	Resource type (e.g. Meeting Room)
ResourceTypeId	number	Resource type identifier
ResourceBusinessId	number	Location identifier
ResourceBusinessName	string	Location display name
ResourceBusinessWebAddress	string	Location subdomain

Schedule

Field	Type	Description
FromTime	string	Start time (business-local)
ToTime	string	End time (business-local)
FromTimeUtc	string	Start time (UTC)
ToTimeUtc	string	End time (UTC)

Status

Field	Type	Description
Tentative	boolean	Whether the booking is tentative
Invoiced	boolean	Whether the booking has been invoiced
IsCancelled	boolean	Whether the booking is cancelled
BookingNumber	number | null	Booking reference number

Timestamps (from base)

Field	Type	Description
CreatedOn	string	Date created (business-local time)
UpdatedOn	string | null	Date last updated (business-local time)
CreatedOnUtc	string	Date created (UTC)
UpdatedOnUtc	string | null	Date last updated (UTC)

Examples

Fetch suggestions

GET /api/public/bookings/suggestions
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

const { resource: suggestions } = useTypedData(httpClient, endpoints.bookings.suggestions())