Skip to main content

Tenant & Companies

Tenants​

In the Kaunt product suite, a tenant represents a partner’s individual customer. Most Kaunt products also include a Company entity beneath the tenant in the hierarchy, used to represent different legal entities belonging to the same customer.

Access to Kaunt’s services is managed through API keys, which are scoped at the tenant level. This means that an API key created for a specific tenant provides access only to that tenant’s data, and not to data from other tenants under the same partner account. This ensures strict data segregation and control across customer environments.

Companies​

A Company within the Kaunt API represents a separate unit containing data only related to that particular Company. The Company entity is used to support the use-case, where a tenant has multiple financial accountings using different chart of accounts.

Company Naming Requirements​

When naming a company in the Kaunt API, the following naming requirements must be met:

  • Can include numbers.
  • Can only use two special characters: _ (underscore) or - (hyphen).
  • Must start with a letter or number.
  • If you use a special character, the name must also include at least one letter.

For example, these are valid names: 23242, mycompany_22, while these are invalid: 23_242, _mycompany.

Should I upload my data using a single company or multiple companies?​

If you can answer yes to at least one of the following statements, you should just stick with a single Company when building the integration towards the Kaunt API.

  • We have multiple departments/financial accountings using the ERP-system, but share the same chart of accounts
  • We only have a single department/financial accounting using the ERP-system

You are advised to create multiple companies within the Kaunt API if you have multiple departments/companies/sections using the same ERP-system, but otherwise do not share the same chart of accounts. By splitting the data into multiple companies, the list of dimensions will be build up using the Postings from each of the Companies individually instead of being pooled together as they would otherwise be if you uploaded everything to a single Company.