Get Legal Status

Check whether the authenticated customer must accept general or contract-specific terms and conditions before using the portal.

GET /api/public/legal/status

Get Legal Status

cURL

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

200

{
  "MustAgreeToTerms": true,
  "AcceptTermsByUtc": {},
  "CanPostponeTerms": true,
  "GeneralTermsAccepted": true,
  "GeneralTerms": "<string>",
  "ContractTerms": [
    {}
  ],
  "ContractTerms[].Id": 123,
  "ContractTerms[].StartDate": "<string>",
  "ContractTerms[].TariffName": "<string>",
  "ContractTerms[].TermsAndConditions": "<string>",
  "401 Unauthorized": {}
}

Get Legal Status

Returns the legal terms acceptance status for the current customer. The portal checks this on every authenticated session bootstrap. If MustAgreeToTerms is true, a modal is shown with the full terms text. It blocks the portal unless CanPostponeTerms is true: then the location’s grace period (setting Legal.TermsGracePeriodDays) is still running, the modal says how long is left, and Remind me later closes it for the rest of the browser tab.

Authentication

Requires a valid customer bearer token.

Response

MustAgreeToTerms · boolean

true when the customer has one or more outstanding terms to accept. Show the acceptance modal when this is true.

AcceptTermsByUtc · string | null

ISO 8601 UTC end of the grace period for the outstanding terms: the earliest one when several documents are pending. null when nothing is pending or the location has no grace period, in which case the terms must be accepted now.

CanPostponeTerms · boolean

true while the grace period is running, so the customer may keep using the portal and accept later. Once it is false with MustAgreeToTerms still true, the modal blocks the portal until the terms are accepted.

GeneralTermsAccepted · boolean

Whether the customer has already accepted the space’s general terms and conditions.

GeneralTerms · string

HTML or plain-text content of the general terms and conditions to display to the customer.

ContractTerms · array | undefined

Array of contract-specific terms the customer must accept. Present only when there are pending contract terms. Each entry contains:

ContractTerms[].Id · number

Unique identifier of the contract.

ContractTerms[].StartDate · string

ISO 8601 date when the contract starts.

ContractTerms[].TariffName · string

Display name of the plan associated with this contract.

ContractTerms[].TermsAndConditions · string

HTML or plain-text content of the contract-specific terms to display.

Example Response

{
  "MustAgreeToTerms": true,
  "AcceptTermsByUtc": "2026-11-09T10:00:00Z",
  "CanPostponeTerms": true,
  "GeneralTermsAccepted": false,
  "GeneralTerms": "<p>By using this portal you agree to our <a href='...'>terms</a>.</p>",
  "ContractTerms": [
    {
      "Id": 101,
      "StartDate": "2026-04-01T00:00:00Z",
      "TariffName": "Hot Desk Monthly",
      "TermsAndConditions": "<p>These terms govern your Hot Desk Monthly membership...</p>"
    }
  ]
}

TypeScript Integration

import endpoints from '@/api/endpoints'
import { useTypedData } from '@/api/fetchData'

const endpoint = endpoints.system.legal_status()

const { resource: legalStatus } = useTypedData(httpClient, endpoint)

if (legalStatus?.MustAgreeToTerms) {
  // Show the legal terms modal
}

Usage in Portal

Context	Source file
Session bootstrap — legal terms gate	src/components/TermsAndConditionsWrapper.tsx
Legal terms acceptance modal	src/components/TermsAndConditionsWrapper.tsx
Grace period and “Remind me later”	src/helpers/termsGracePeriod.ts

Error Responses

401 Unauthorized · error

The bearer token is missing, expired, or invalid. The customer must sign in.

Related Endpoints

Method	Endpoint	Description
POST	/api/public/legal/accept	Record acceptance of outstanding terms