> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Current Business

> Retrieve the full profile and configuration for the Nexudus location associated with the current portal session.

# 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

<ParamField query="_shape" type="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. Example: `_shape=Name,WebAddress,Currency.Code,TimeZone`.
</ParamField>

## Response

Returns a `Business` object. Key fields are described below.

### Identity

<ResponseField name="Id" type="number">
  Unique numeric identifier for the location.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  Globally unique identifier (GUID) for the location. Used in floor plan and booking requests.
</ResponseField>

<ResponseField name="Name" type="string">
  Display name of the coworking space.
</ResponseField>

<ResponseField name="WebAddress" type="string">
  The subdomain identifier used in API requests (e.g. `"myspace"` in `myspace.spaces.nexudus.com`).
</ResponseField>

### Localisation

<ResponseField name="Currency" type="object">
  Currency object for the location.
</ResponseField>

<ResponseField name="Currency.Code" type="string">
  ISO 4217 currency code (e.g. `"GBP"`, `"USD"`, `"EUR"`).
</ResponseField>

<ResponseField name="Currency.Name" type="string">
  Display name of the currency (e.g. `"British Pound"`).
</ResponseField>

<ResponseField name="Currency.Format" type="string">
  Currency format string.
</ResponseField>

<ResponseField name="LanguageCulture" type="string">
  Default BCP 47 culture string for the location (e.g. `"en-GB"`).
</ResponseField>

<ResponseField name="TimeZone" type="string">
  IANA time zone identifier for the location (e.g. `"Europe/London"`).
</ResponseField>

### Contact

<ResponseField name="Address" type="string">
  Street address of the location.
</ResponseField>

<ResponseField name="TownCity" type="string">
  City or town where the location is based.
</ResponseField>

<ResponseField name="PostalCode" type="string">
  Postal code of the location.
</ResponseField>

<ResponseField name="Country" type="object">
  Country object with `Id`, `Name`, and `TwoDigitsCode` fields.
</ResponseField>

### Portal URLs

<ResponseField name="NativeHomeUrl" type="string">
  Base URL of the Nexudus backend for this location (used to build authenticated redirects).
</ResponseField>

<ResponseField name="NativeHomeUrlWithLanguage" type="string">
  Base URL including the default language prefix (e.g. `/en`). Used for authenticated redirect links.
</ResponseField>

## TypeScript Integration

```typescript theme={null}
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

<ResponseField name="401 Unauthorized" type="error">
  Authentication is required and no valid token was supplied.
</ResponseField>

<ResponseField name="404 Not Found" type="error">
  No location could be resolved for the current session context.
</ResponseField>

## Related Endpoints

| 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         |