API Docs / Schemas / TenantDto

TenantDto

An organisation (tenant) and its configuration

Properties

Name Type Description
code*string

The URL-friendly unique identifier for the tenant (used in API paths)

The URL-friendly unique identifier for the tenant (used in API paths)

name*string

The human-readable name of the tenant

The human-readable name of the tenant

statusenum

LapsedTrialist LapsedCustomer ActiveTrialist PendingConversion PayingCustomer Freemium

LapsedTrialist LapsedCustomer ActiveTrialist PendingConversion PayingCustomer Freemium

createdDatestring

When the tenant was created

When the tenant was created

updatedDatestring

When the tenant was last updated

When the tenant was last updated

accountingConnectionCodeAndNameDto
directDebitConnectionCodeAndNameDto
amlConnectionCodeAndNameDto
documentStorageConnectionCodeAndNameDto
hmrcConnectionCodeAndNameDto
proposalConnectionCodeAndNameDto
autoCreateClientFoldersboolean

Whether Sodium automatically creates subfolders for each client under the document storage base folder.
Only applicable when an external document storage provider is connected.
When false, users must manually map each client to a pre-existing folder.

Whether Sodium automatically creates subfolders for each client under the document storage base folder.
Only applicable when an external document storage provider is connected.
When false, users must manually map each client to a pre-existing folder.

activeClientCountinteger

Count of clients with Active status

Count of clients with Active status

inactiveClientCountinteger

Count of clients with Inactive status

Count of clients with Inactive status

prospectClientCountinteger

Count of clients with Prospect status

Count of clients with Prospect status

lostProspectClientCountinteger

Count of clients with LostProspect status

Count of clients with LostProspect status

servicesCountinteger

Count of services in the tenant

Count of services in the tenant

workFlowsCountinteger

Count of workflows in the tenant

Count of workflows in the tenant

usersCountinteger

Count of users in the tenant

Count of users in the tenant

kanbanBoardServiceCountinteger

Count of services with kanban boards enabled

Count of services with kanban boards enabled

kanbanBoardPipelineCountinteger

Count of pipelines with kanban boards enabled

Count of pipelines with kanban boards enabled

salesPipelineEnabledboolean

Whether the Sales Pipeline feature is enabled for this tenant. Gates the pipeline UI.

Whether the Sales Pipeline feature is enabled for this tenant. Gates the pipeline UI.

proposalsSentThisMonthinteger

Number of unique proposals sent this calendar month

Number of unique proposals sent this calendar month

isSupportAccessEnabledboolean

Whether or not support access is enabled, allowing
support agents to access the tenant's data for troubleshooting.

Whether or not support access is enabled, allowing
support agents to access the tenant's data for troubleshooting.

canAccessBetaFeaturesboolean

Whether this tenant can access beta features

Whether this tenant can access beta features

isDisabledboolean

Whether this tenant is disabled

Whether this tenant is disabled

disabledReasonstring

The reason the tenant was disabled, if applicable

The reason the tenant was disabled, if applicable

isTasksDisabledboolean

Whether task materialization is disabled for this tenant

Whether task materialization is disabled for this tenant

isMissingRequiredBillingInfoboolean

Whether this tenant is on a paid plan but hasn't completed billing/DD setup

Whether this tenant is on a paid plan but hasn't completed billing/DD setup

isSubscriptionCancelledboolean

Whether this tenant has cancelled their subscription.
Cancelled tenants retain access until their current subscription ends.

Whether this tenant has cancelled their subscription.
Cancelled tenants retain access until their current subscription ends.

lastUserLoginstring

The most recent login timestamp across all users in this tenant

The most recent login timestamp across all users in this tenant

expiredDatestring

When the tenant's subscription expired: the EndDate of the most recently ended subscription.
Null for tenants that have never had a subscription end. Primarily relevant for lapsed trialists and customers.

When the tenant's subscription expired: the EndDate of the most recently ended subscription.
Null for tenants that have never had a subscription end. Primarily relevant for lapsed trialists and customers.

trialEndDatestring

The EndDate of the tenant's current, in-progress free trial - a future date while the trial is running, otherwise null.
Drives the "days left" countdown for active trialists. Distinct from ExpiredDate, which reflects the last subscription that already ended.

The EndDate of the tenant's current, in-progress free trial - a future date while the trial is running, otherwise null.
Drives the "days left" countdown for active trialists. Distinct from ExpiredDate, which reflects the last subscription that already ended.

logoUrlstring

The URL of the tenant's logo image

The URL of the tenant's logo image

JSON Example

{
  "code": "string",
  "name": "string",
  "status": "LapsedTrialist",
  "createdDate": "2024-01-01T00:00:00Z",
  "updatedDate": "2024-01-01T00:00:00Z"
}

Used By Operations