Check tenant status - SuperOffice

Integrations that connect to SuperOffice Online must always resolve the tenant’s current environment dynamically. The tenant’s operational location, such as state and subdomain, can change at any time as part of normal platform operations. Because of this, your integration cannot rely on stored or hard‑coded URLs. The Tenant Status API provides the authoritative, up‑to‑date information about where a tenant currently lives. By checking status regularly, your integration automatically follows the tenant if it is moved or it’s currently offline. The following parameters are required to send a request to the state API:

Set ENVIR to sod, qaonline or online depending on where your application runs.
Set CONTEXTID to your context identifier, for example, Cust12345.

GET https://ENVIR.superoffice.com/api/state/CONTEXTID

Request example

GET https://online.superoffice.com/api/state/Cust12345

Response example

{
    "ContextIdentifier": "Cust12345",
    "Endpoint": "https://online2.superoffice.com/Cust12345",
    "State": "Running",
    "IsRunning": true,
    "ValidUntil": "2026-02-23T09:52:01.9342965Z",
    "Api": "https://online2.superoffice.com/Cust12345/api",
    "Version": "Release_11.10_2026.02.24-02"
}

ContextIdentifier

Context identifier, for example, Cust12345

Endpoint

The root path of customer installation. This path will change routinely to balance the load. Changes may also occur under special circumstances such as incidents. For example, https://``**online2**``.superoffice.com/Cust12345 may shift to https://``**app**``.superoffice.com/Cust12345 or even https://``**disasterrecovery**``.superoffice.com/Cust12345

From November 17. 2023, calls to the wrong public endpoint return HTTP status code 421 - Misdirected request with an additional error description saying “Wrong subdomain used to access tenant”. Subdomains without a number identifier, such as sod.superoffice.com and online.superoffice.com, are reserved for authentication. Use the tenant-specific endpoint (with a number) for API calls. For example, sod2.superoffice.com or online3.superoffice.com. Because the subdomain part of the endpoint changes, and the application should respond to these changes, we recommend that you do not hardcode the path.

State

Value	Description
Unknown (0)	The customer tenant is unknown, or there is something wrong with the environment. If the customer was previously in another state, we probably have an incident of sorts.
Provisioning (1)	We are in the state of provisioning the customer. Should be ready in a short time.
Running (2)	The customer tenant is running. All is good.
Deleted (3)	The customer tenant has been deleted, forget all about it.
Suspended (4)	The customer tenant is in termination. APIs are not available, and the customer can still take action to reactivate his subscription. Resuming a customer in termination typically occurs at night or by manual activation by the sales team.
OnlineMaintenance (5)	We are performing background tasks, but nothing preventing customers from performing normal operations. API is available. Background tasks might take some time before they start.
OfflineMaintenance (6)	The customer tenant is offline for maintenance. This typically happens during an upgrade. It usually takes minutes for the customer to be online again. APIs are not available.
ProvisioningFailed (8)	Provisioning has failed.
Deleting (10)	We are in the process of deleting the customer. Expect the customer to be deleted shortly.
DeleteFailed (11)	Deleting the customer failed. Expect the customer to be deleted in a while.
MigrationPending (12)	This is a new migration to online that has not yet been completed. Expect the customer to be running at a later time. Customers are often in state MigrationPending for days or weeks.

IsRunning

This indicates whether the tenant is up and running. Values:

Running
OnlineMaintenance

ValidUntil

When to check next time if an updated state is needed.

API

Link to more information about API version details. Example:

{
    "v1": "https://online2.superoffice.com/Cust12345/api/v1/",
    "NetServerVersion": "11.10.721.0",
    "NetServerAssembly": "11.10.0.0",
    "NetServerDate": "2026-02-24",
    "NetServerLabel": "Release_11.10_2026.02.24-02",
    "NetServer": "SuperOffice 11.10 NetServer 11.10 Release (Build: Release_11.10_2026.02.24-02)",
    "Services": "Services87",
    "ServicesCurrent": "Services88",
    "Version": "v1",
    "Documentation": "https://docs.superoffice.com/en/api/"
}

​Request example

​Response example

​ContextIdentifier

​Endpoint

​State

​IsRunning

​ValidUntil

​API