Get Current Business
Returns the full details of the Nexudus location (business) that the current portal session is operating under. This is the primary bootstrap call the portal makes when the application loads. The response drives theming, feature flags, localisation, and all location-specific configuration.
Authentication
Requires a valid customer bearer token, or can return public data for unauthenticated sessions depending on location configuration.
Query Parameters
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. Example: _shape=Name,WebAddress,Currency.Code,TimeZone.
Response
Returns a Business object. Key fields are described below.
Identity
Unique numeric identifier for the location.
Globally unique identifier (GUID) for the location. Used in floor plan and booking requests.
Display name of the coworking space.
The subdomain identifier used in API requests (e.g. "myspace" in myspace.spaces.nexudus.com).
Localisation
Currency object for the location.
ISO 4217 currency code (e.g. "GBP", "USD", "EUR").
Display name of the currency (e.g. "British Pound").
Default BCP 47 culture string for the location (e.g. "en-GB").
IANA time zone identifier for the location (e.g. "Europe/London").
Street address of the location.
City or town where the location is based.
Postal code of the location.
Country object with Id, Name, and TwoDigitsCode fields.
Portal URLs
Base URL of the Nexudus backend for this location (used to build authenticated redirects).
NativeHomeUrlWithLanguage
Base URL including the default language prefix (e.g. /en). Used for authenticated redirect links.
TypeScript Integration
import endpoints from '@/api/endpoints'
import { useData } from '@/api/fetchData'
import { Business } from '@/types/Business'
const { resource: business } = useData<Business>(httpClient, endpoints.system.business.current)
Usage in Portal
| Context | Source file |
|---|
| Location context provider (app bootstrap) | src/states/useLocationByRouteContext.tsx |
| Business details throughout the portal | src/states/useLocationByHostContext.tsx |
Error Responses
Authentication is required and no valid token was supplied.
No location could be resolved for the current session context.
| Method | Endpoint | Description |
|---|
GET | /api/public/configuration | Get portal feature configuration |
GET | /api/public/businesses/all | List all locations in the network |
GET | /api/public/businesses/withVisitors | List locations that have visitor registration |
GET | /api/public/businesses/withTour | List locations that offer space tours |