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

​
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

FieldTypeDescription
Suggestionsobject[]Array of booking suggestion objects

​
Suggestion Fields (BookingDrop)

​
Identity

FieldTypeDescription
IdnumberUnique numeric identifier for the booking
UniqueIdstringGlobally unique identifier

​
Resource

FieldTypeDescription
ResourceNamestringResource display name
ResourceIdnumberResource identifier
ResourceTypeNamestringResource type (e.g. Meeting Room)
ResourceTypeIdnumberResource type identifier
ResourceBusinessIdnumberLocation identifier
ResourceBusinessNamestringLocation display name
ResourceBusinessWebAddressstringLocation subdomain

​
Schedule

FieldTypeDescription
FromTimestringStart time (business-local)
ToTimestringEnd time (business-local)
FromTimeUtcstringStart time (UTC)
ToTimeUtcstringEnd time (UTC)

​
Status

FieldTypeDescription
TentativebooleanWhether the booking is tentative
InvoicedbooleanWhether the booking has been invoiced
IsCancelledbooleanWhether the booking is cancelled
BookingNumbernumber | nullBooking reference number

​
Timestamps (from base)

FieldTypeDescription
CreatedOnstringDate created (business-local time)
UpdatedOnstring | nullDate last updated (business-local time)
CreatedOnUtcstringDate created (UTC)
UpdatedOnUtcstring | nullDate 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())