> ## 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 one Business

> Retrieve a single Business record by its Id.

A **Business** represents an individual location or a group of locations in Nexudus. Most records in the system are connected — directly or via other records — to a business, which controls access and visibility based on the locations a user or customer can access.

Businesses can be organised into a hierarchy using `RootLocationId`, which references the parent business of a given business. A business with no `RootLocationId` is a top-level location. Child businesses inherit certain configuration from their parent.

Each business defines its own address, contact details, currency, opening hours, and public-facing content (Passport profile, website text, branding images). Read-only properties such as opening hours, theme, and image URLs reflect the current configuration set through the Nexudus admin UI.

## Authentication

<Note>
  This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
  The authenticated user must be a full unrestricted administrator or have the **`Business-Read`** role.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the Business record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/sys/businesses/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/sys/businesses/87654321',
    {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://spaces.nexudus.com/api/sys/businesses/87654321',
      headers={
          'Authorization': 'Bearer YOUR_TOKEN'
      }
  )

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="VisitedHelpItems" type="integer">
  The visited help items value for this business. See `eHelpItemFlag` enum values: `0` = None, `1` = WelcomePage, `2` = GridPage, `4` = EditPage, `8` = SettingsPage, `16` = HelpPage.
</ResponseField>

<ResponseField name="Name" type="string">
  Display name of the business location.
</ResponseField>

<ResponseField name="DefaultLanguage" type="integer">
  Default language identifier for communications and UI. See `eLanguage` enum values: `3` = EnglishUK, `1` = EnglishUS, `2` = Spanish.
</ResponseField>

<ResponseField name="SpaceWebsiteLanguageId" type="integer">
  ID of the space website language linked to this record.
</ResponseField>

<ResponseField name="SpaceWebsiteLanguageCulture" type="string">
  Culture code (e.g. en-GB) for the business's public website.
</ResponseField>

<ResponseField name="RootLocationId" type="integer">
  ID of the root location linked to this record.
</ResponseField>

<ResponseField name="WebAddress" type="string">
  URL slug used for the business's public web address.
</ResponseField>

<ResponseField name="DefaultPaymentGatewayId" type="integer">
  ID of the default payment gateway linked to this record.
</ResponseField>

<ResponseField name="NextInvoice" type="string">
  Date of the next scheduled invoice run.
</ResponseField>

<ResponseField name="TermsAndConditions" type="string">
  Terms and conditions text for this business.
</ResponseField>

<ResponseField name="ShortIntroduction" type="string">
  Brief introduction shown on the business profile.
</ResponseField>

<ResponseField name="AboutUs" type="string">
  Extended 'About Us' text for the business profile.
</ResponseField>

<ResponseField name="Quote" type="string">
  Highlight quote displayed on the business profile.
</ResponseField>

<ResponseField name="PrivacyPolicyUrl" type="string">
  URL to the business's privacy policy.
</ResponseField>

<ResponseField name="CookiePolicyUrl" type="string">
  URL to the business's cookie policy.
</ResponseField>

<ResponseField name="WebContact" type="string">
  Public-facing web contact URL.
</ResponseField>

<ResponseField name="WelcomeEmail" type="string">
  The welcome email value for this business.
</ResponseField>

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

<ResponseField name="Phone" type="string">
  Primary phone number displayed on the business profile.
</ResponseField>

<ResponseField name="Fax" type="string">
  Fax number.
</ResponseField>

<ResponseField name="EmailContact" type="string">
  Primary email address displayed on the business profile.
</ResponseField>

<ResponseField name="TrialExpireDate" type="string">
  Date/time value for trial expire date.
</ResponseField>

<ResponseField name="LastOverDueInvoiceReminder" type="string">
  Date/time value for last over due invoice reminder.
</ResponseField>

<ResponseField name="LastWelcomeEmail" type="string">
  Date/time value for last welcome email.
</ResponseField>

<ResponseField name="CountryId" type="integer">
  ID of the country linked to this record.
</ResponseField>

<ResponseField name="CountryName" type="string">
  Name of the country (resolved from CountryId).
</ResponseField>

<ResponseField name="CurrencyId" type="integer">
  ID of the currency linked to this record.
</ResponseField>

<ResponseField name="CurrencyCode" type="string">
  ISO currency code (resolved from CurrencyId).
</ResponseField>

<ResponseField name="SimpleTimeZoneId" type="integer">
  ID of the simple time zone linked to this record.
</ResponseField>

<ResponseField name="LogoFileName" type="string">
  Current file name of the logo (read-only; upload via the corresponding URL field).
</ResponseField>

<ResponseField name="NewLogoUrl" type="string">
  URL of a new file to upload as the logo.
</ResponseField>

<ResponseField name="ClearLogoFile" type="boolean">
  Set to true to remove the current logo file.
</ResponseField>

<ResponseField name="BannerImageFileName" type="string">
  Current file name of the banner image (read-only; upload via the corresponding URL field).
</ResponseField>

<ResponseField name="NewBannerImageUrl" type="string">
  URL of a new file to upload as the banner image.
</ResponseField>

<ResponseField name="ClearBannerImageFile" type="boolean">
  Set to true to remove the current banner image file.
</ResponseField>

<ResponseField name="NexIoBannerImageFileName" type="string">
  Current file name of the nex io banner image (read-only; upload via the corresponding URL field).
</ResponseField>

<ResponseField name="NewNexIoBannerImageUrl" type="string">
  URL of a new file to upload as the nex io banner image.
</ResponseField>

<ResponseField name="ClearNexIoBannerImageFile" type="boolean">
  Set to true to remove the current nex io banner image file.
</ResponseField>

<ResponseField name="DiscountPercentage" type="number">
  The discount percentage value for this business.
</ResponseField>

<ResponseField name="DiscountAmount" type="number">
  The discount amount value for this business.
</ResponseField>

<ResponseField name="LastLanguageTokenUpdate" type="string">
  Date/time value for last language token update.
</ResponseField>

<ResponseField name="HasCreatedDefaultFileTemplates" type="boolean">
  Whether has created default file templates is enabled.
</ResponseField>

<ResponseField name="InvoicingPeriod" type="integer">
  The invoicing period value for this business.
</ResponseField>

<ResponseField name="Suspended" type="boolean">
  Whether suspended is enabled.
</ResponseField>

<ResponseField name="CustomPassportApp" type="boolean">
  Whether custom passport app is enabled.
</ResponseField>

<ResponseField name="RemindersProcessedOn" type="string">
  Date/time value for reminders processed on.
</ResponseField>

<ResponseField name="PreAuthId" type="string">
  ID of the pre auth associated with this record.
</ResponseField>

<ResponseField name="Last4Digits" type="string">
  Last 4 digits of the payment card on file.
</ResponseField>

<ResponseField name="PreAuthLastError" type="string">
  Most recent pre-authorisation error message.
</ResponseField>

<ResponseField name="PreAuthProcessedOn" type="string">
  Date/time value for pre auth processed on.
</ResponseField>

<ResponseField name="LastChargedInvoice" type="integer">
  The last charged invoice value for this business.
</ResponseField>

<ResponseField name="LastChargedTransaction" type="integer">
  The last charged transaction value for this business.
</ResponseField>

<ResponseField name="LastChargedAttendee" type="integer">
  The last charged attendee value for this business.
</ResponseField>

<ResponseField name="PassportChannels" type="string">
  Passport channels this business is listed under.
</ResponseField>

<ResponseField name="PassportOnly" type="boolean">
  Whether passport only is enabled.
</ResponseField>

<ResponseField name="PassportPublished" type="boolean">
  Whether this business is published and visible on Nexudus Passport.
</ResponseField>

<ResponseField name="PassportBannerFileName" type="string">
  Current file name of the passport banner (read-only; upload via the corresponding URL field).
</ResponseField>

<ResponseField name="NewPassportBannerUrl" type="string">
  URL of a new file to upload as the passport banner.
</ResponseField>

<ResponseField name="ClearPassportBannerFile" type="boolean">
  Set to true to remove the current passport banner file.
</ResponseField>

<ResponseField name="PassportSpaceName" type="string">
  Display name shown on the Nexudus Passport listing.
</ResponseField>

<ResponseField name="PassportTagLine" type="string">
  Tagline shown on the Nexudus Passport listing.
</ResponseField>

<ResponseField name="VenueType" type="integer">
  Type of venue (0 = default). See `eVenueType` enum values: `1` = BusinessCenter, `2` = CorporateOffice, `3` = CoworkingSpace, `4` = Hotel, `5` = InformalOffice, `6` = Studio, `7` = Other.
</ResponseField>

<ResponseField name="Tags" type="string">
  Comma-separated tags for categorising the business.
</ResponseField>

<ResponseField name="NumberOfFloors" type="integer">
  Number of floors in the business premises.
</ResponseField>

<ResponseField name="FloorSpace" type="integer">
  Total floor space of the business premises.
</ResponseField>

<ResponseField name="FloorSpaceUnit" type="integer">
  Unit for FloorSpace (0 = default). See `eFloorUnit` enum values: `1` = SqFt, `2` = SqMt.
</ResponseField>

<ResponseField name="Longitude" type="number">
  Longitude coordinate for map positioning.
</ResponseField>

<ResponseField name="Latitude" type="number">
  Latitude coordinate for map positioning.
</ResponseField>

<ResponseField name="PassportDescription" type="string">
  Full description shown on the Nexudus Passport listing.
</ResponseField>

<ResponseField name="TownCity" type="string">
  Town or city where the business is located.
</ResponseField>

<ResponseField name="State" type="string">
  State or province where the business is located.
</ResponseField>

<ResponseField name="PostalCode" type="string">
  Postal or ZIP code.
</ResponseField>

<ResponseField name="StreetName" type="string">
  Street name component of the address.
</ResponseField>

<ResponseField name="StreetNumber" type="string">
  Street number component of the address.
</ResponseField>

<ResponseField name="Neighborhood" type="string">
  Neighborhood or district name.
</ResponseField>

<ResponseField name="ContactPhoneNumber" type="string">
  Secondary contact phone number.
</ResponseField>

<ResponseField name="ContactEmail" type="string">
  Secondary contact email address.
</ResponseField>

<ResponseField name="PassportMembersAccess" type="integer">
  Passport members directory access level. See `ePassportAccess` enum values: `1` = Everyone, `2` = RegisteredUsers, `3` = RegisteredWithMySpaceUsers, `4` = NoOne.
</ResponseField>

<ResponseField name="PassportEventsAccess" type="integer">
  Passport events listing access level. See `ePassportAccess` enum values: `1` = Everyone, `2` = RegisteredUsers, `3` = RegisteredWithMySpaceUsers, `4` = NoOne.
</ResponseField>

<ResponseField name="PassportCommunityAccess" type="integer">
  Passport community board access level. See `ePassportAccess` enum values: `1` = Everyone, `2` = RegisteredUsers, `3` = RegisteredWithMySpaceUsers, `4` = NoOne.
</ResponseField>

<ResponseField name="PassportBlogPostsAccess" type="integer">
  Passport blog posts access level. See `ePassportAccess` enum values: `1` = Everyone, `2` = RegisteredUsers, `3` = RegisteredWithMySpaceUsers, `4` = NoOne.
</ResponseField>

<ResponseField name="MondayOpenTime" type="integer">
  Monday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="MondayCloseTime" type="integer">
  Monday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="TuesdayOpenTime" type="integer">
  Tuesday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="TuesdayCloseTime" type="integer">
  Tuesday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="WednesdayOpenTime" type="integer">
  Wednesday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="WednesdayCloseTime" type="integer">
  Wednesday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="ThursdayOpenTime" type="integer">
  Thursday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="ThursdayCloseTime" type="integer">
  Thursday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="FridayOpenTime" type="integer">
  Friday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="FridayCloseTime" type="integer">
  Friday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="SaturdayOpenTime" type="integer">
  Saturday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="SaturdayCloseTime" type="integer">
  Saturday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="SundayOpenTime" type="integer">
  Sunday opening time (minutes from midnight).
</ResponseField>

<ResponseField name="SundayCloseTime" type="integer">
  Sunday closing time (minutes from midnight).
</ResponseField>

<ResponseField name="MondayClosed" type="boolean">
  Whether the business is closed on Mondays.
</ResponseField>

<ResponseField name="TuesdayClosed" type="boolean">
  Whether the business is closed on Tuesdays.
</ResponseField>

<ResponseField name="WednesdayClosed" type="boolean">
  Whether the business is closed on Wednesdays.
</ResponseField>

<ResponseField name="ThursdayClosed" type="boolean">
  Whether the business is closed on Thursdays.
</ResponseField>

<ResponseField name="FridayClosed" type="boolean">
  Whether the business is closed on Fridays.
</ResponseField>

<ResponseField name="SaturdayClosed" type="boolean">
  Whether the business is closed on Saturdays.
</ResponseField>

<ResponseField name="SundayClosed" type="boolean">
  Whether the business is closed on Sundays.
</ResponseField>

<ResponseField name="SameOpeningTimes" type="boolean">
  Whether all days share the same opening and closing times.
</ResponseField>

<ResponseField name="CurrentThemeName" type="string">
  Name of the currently active website theme.
</ResponseField>

<ResponseField name="CurrentBackEndVersion" type="integer">
  The current back end version value for this business.
</ResponseField>

<ResponseField name="AuthenticationProvider" type="string">
  The authentication provider value for this business.
</ResponseField>

<ResponseField name="CreatedBy" type="string">
  The created by value for this business.
</ResponseField>

<ResponseField name="DefaultPaymentTerm" type="integer">
  The default payment term value for this business.
</ResponseField>

<ResponseField name="OnBoardingTier" type="string">
  Onboarding support tier for this business.
</ResponseField>

<ResponseField name="SupportTier" type="string">
  Customer support tier for this business.
</ResponseField>

<ResponseField name="SupportUrl" type="string">
  URL for the business's support portal.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "VisitedHelpItems": 0,
  "Name": "",
  "DefaultLanguage": 0,
  "SpaceWebsiteLanguageId": null,
  "SpaceWebsiteLanguageCulture": null,
  "RootLocationId": null,
  "WebAddress": "",
  "DefaultPaymentGatewayId": null,
  "NextInvoice": null,
  "TermsAndConditions": null,
  "ShortIntroduction": null,
  "AboutUs": null,
  "Quote": null,
  "PrivacyPolicyUrl": null,
  "CookiePolicyUrl": null,
  "WebContact": null,
  "WelcomeEmail": null,
  "Address": null,
  "Phone": null,
  "Fax": null,
  "EmailContact": null,
  "TrialExpireDate": null,
  "LastOverDueInvoiceReminder": null,
  "LastWelcomeEmail": null,
  "CountryId": 0,
  "CountryName": null,
  "CurrencyId": 0,
  "CurrencyCode": null,
  "SimpleTimeZoneId": 0,
  "LogoFileName": null,
  "NewLogoUrl": null,
  "ClearLogoFile": null,
  "BannerImageFileName": null,
  "NewBannerImageUrl": null,
  "ClearBannerImageFile": null,
  "NexIoBannerImageFileName": null,
  "NewNexIoBannerImageUrl": null,
  "ClearNexIoBannerImageFile": null,
  "DiscountPercentage": 0,
  "DiscountAmount": 0,
  "LastLanguageTokenUpdate": null,
  "HasCreatedDefaultFileTemplates": false,
  "InvoicingPeriod": 0,
  "Suspended": false,
  "CustomPassportApp": false,
  "RemindersProcessedOn": null,
  "PreAuthId": null,
  "Last4Digits": null,
  "PreAuthLastError": null,
  "PreAuthProcessedOn": null,
  "LastChargedInvoice": 0,
  "LastChargedTransaction": 0,
  "LastChargedAttendee": 0,
  "PassportChannels": null,
  "PassportOnly": false,
  "PassportPublished": false,
  "PassportBannerFileName": null,
  "NewPassportBannerUrl": null,
  "ClearPassportBannerFile": null,
  "PassportSpaceName": null,
  "PassportTagLine": null,
  "VenueType": 0,
  "Tags": null,
  "NumberOfFloors": null,
  "FloorSpace": null,
  "FloorSpaceUnit": 0,
  "Longitude": null,
  "Latitude": null,
  "PassportDescription": null,
  "TownCity": null,
  "State": null,
  "PostalCode": null,
  "StreetName": null,
  "StreetNumber": null,
  "Neighborhood": null,
  "ContactPhoneNumber": null,
  "ContactEmail": null,
  "PassportMembersAccess": 0,
  "PassportEventsAccess": 0,
  "PassportCommunityAccess": 0,
  "PassportBlogPostsAccess": 0,
  "MondayOpenTime": null,
  "MondayCloseTime": null,
  "TuesdayOpenTime": null,
  "TuesdayCloseTime": null,
  "WednesdayOpenTime": null,
  "WednesdayCloseTime": null,
  "ThursdayOpenTime": null,
  "ThursdayCloseTime": null,
  "FridayOpenTime": null,
  "FridayCloseTime": null,
  "SaturdayOpenTime": null,
  "SaturdayCloseTime": null,
  "SundayOpenTime": null,
  "SundayCloseTime": null,
  "MondayClosed": false,
  "TuesdayClosed": false,
  "WednesdayClosed": false,
  "ThursdayClosed": false,
  "FridayClosed": false,
  "SaturdayClosed": false,
  "SundayClosed": false,
  "SameOpeningTimes": false,
  "CurrentThemeName": null,
  "CurrentBackEndVersion": null,
  "AuthenticationProvider": null,
  "CreatedBy": null,
  "DefaultPaymentTerm": null,
  "OnBoardingTier": null,
  "SupportTier": null,
  "SupportUrl": null,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "Business Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```