GET

api

public

bookings

AI Booking Suggestions

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

import requests

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

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/ai/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Response": {},
  "Response.resource_type": "<string>",
  "Response.partySize": 123,
  "Response.durationMinutes": 123,
  "Response.timeConstraints": {},
  "Response.timeConstraints.kind": "<string>",
  "Response.timeConstraints.startISO": "<string>",
  "Response.timeConstraints.endISO": "<string>",
  "Response.timeConstraints.recurrence": "<string>",
  "Response.location": "<string>",
  "Response.amenities": {},
  "Response.flexibilityMinutes": 123,
  "Response.budget": 123,
  "Response.notes": "<string>",
  "401 Unauthorized": {},
  "400 Bad Request": {}
}

AI Booking Suggestions

Parses a natural language prompt into a structured booking intent, including time window, duration, party size, desired amenities, resource type, and notes. Use the parsed fields to prefill the bookings search UI.

Authentication

Requires an authenticated customer session.

Query Parameters

string

required

The user’s natural language booking description. Example: “A meeting room for 10 with a projector next Tuesday 3–5pm”.

Response

object

Structured booking intent.

string

Resource type classification, e.g. “room|Meeting Room”.

number

Number of attendees.

number

Desired booking duration in minutes.

object

Preferred time window.

string

Type of time constraint (e.g., fixed, range, recurring).

string

ISO 8601 start datetime.

string

ISO 8601 end datetime.

string

Recurrence rule, if applicable.

string

Named location reference, if extracted.

array[string]

Desired amenities (keys correspond to booking filters).

number

Acceptable shift in start time, in minutes.

number

Optional budget indication.

string

Free-form notes extracted from the prompt.

Example Response

{
  "Response": {
    "resource_type": "room|Meeting Room",
    "partySize": 10,
    "durationMinutes": 120,
    "timeConstraints": {
      "kind": "fixed",
      "startISO": "2025-10-07T15:00:00.000Z",
      "endISO": "2025-10-07T17:00:00.000Z",
      "recurrence": ""
    },
    "location": "Downtown",
    "amenities": ["VideoConferencing", "Projector"],
    "flexibilityMinutes": 30,
    "budget": 0,
    "notes": "Board presentation"
  }
}

Usage in Portal

Public Bookings – Day and duration shortcuts
- src/views/public/bookings/components/DayAndDurationShortCuts.tsx (applies AI intent to querystring)

GET /api/public/ai/chats/{sessionId} – General-purpose assistant chat
GET /api/public/ai/tariffs – Plan suggestions by prompt
GET /api/public/ai/products – Product suggestions by prompt

Error Responses

error

The user is not authenticated.

error

Missing or invalid prompt.

AI Product Suggestions

AI Booking Suggestions

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

import requests

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

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/ai/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Response": {},
  "Response.resource_type": "<string>",
  "Response.partySize": 123,
  "Response.durationMinutes": 123,
  "Response.timeConstraints": {},
  "Response.timeConstraints.kind": "<string>",
  "Response.timeConstraints.startISO": "<string>",
  "Response.timeConstraints.endISO": "<string>",
  "Response.timeConstraints.recurrence": "<string>",
  "Response.location": "<string>",
  "Response.amenities": {},
  "Response.flexibilityMinutes": 123,
  "Response.budget": 123,
  "Response.notes": "<string>",
  "401 Unauthorized": {},
  "400 Bad Request": {}
}

​AI Booking Suggestions

​Authentication

​Query Parameters

​Response

​Example Response

​Usage in Portal

​Related Endpoints

​Error Responses

AI Booking Suggestions

Authentication

Query Parameters

Response

Example Response

Usage in Portal

Related Endpoints

Error Responses