Company

Find KLARA business company of tenant

Retrieve the business company of a tenant. Use your KLARA token from your username & password & tenant-id.

get/core/v2/tenants/companies

Request

  • Base URL: https://api.klara.ch
  • URL: https://api.klara.ch/core/v2/tenants/companies
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Response

Company found

namestring required

Name of the company

legalForm'LIMITED_LIABILITY' | 'CORPORATION' | 'OR' | 'INDIVIDUALLY_OWNED_COMPANY' | 'ASSOCIATION' | 'SIMPLE_PARTNERSHIP' | 'GENERAL_PARTNERSHIP' | 'LIMITED_PARTNERSHIP' | 'COOPERATIVE_COMPANY' | 'FOUNDATION' | 'IOER' required

Legal form of the company. Send the value as one of the LegalForm constants below; the German abbreviation in brackets is also accepted on input, but responses always carry the constant. <ul><li><code>LIMITED_LIABILITY</code> - limited liability company (GmbH)</li><li><code>CORPORATION</code> - public limited company (AG)</li><li><code>INDIVIDUALLY_OWNED_COMPANY</code> - individually owned company (EU)</li><li><code>ASSOCIATION</code> - association (V)</li><li><code>SIMPLE_PARTNERSHIP</code> - simple partnership (EG)</li><li><code>GENERAL_PARTNERSHIP</code> - general partnership (KG)</li><li><code>LIMITED_PARTNERSHIP</code> - limited partnership (KDG)</li><li><code>COOPERATIVE_COMPANY</code> - cooperative company (G)</li><li><code>FOUNDATION</code> - foundation (S)</li><li><code>OR</code> - simple company under the Swiss Code of Obligations (OR)</li><li><code>IOER</code> - institution of public law</li></ul>

language'de' | 'en' | 'fr' | 'it' required

Preferred language of the company. Supported: English, German, French, Italian

corporateIdentificationNumberstring

Every business active in Switzerland is given a unique enterprise identification number (UID). To ensure that numbers are correctly allocated and managed, the UID register is run by the Federal Statistical Office

foundingDatestring date

Founding date of this company in ISO 8601 format (yyyy-mm-dd)

Example response

{
  "name": "ABC-Corp",
  "legalForm": "LIMITED_LIABILITY",
  "phones": [
    {
      "id": "1",
      "phoneNumber": "+41783334444",
      "type": "PRIVATE"
    }
  ],
  "emails": [
    {
      "id": "1",
      "emailAddress": "example@gmail.com",
      "type": "PRIVATE"
    }
  ],
  "addresses": [
    {
      "id": "1",
      "addressLines": "Chemin de la Caquerette 12",
      "addressType": "WORK",
      "cityName": "Bern",
      "cityZipCode": "3003",
      "countryIso2Code": "CH",
      "countryIso3Code": "CHE",
      "countryNumericCode": "756",
      "city_href": "https://api.klara.ch/core/latest/cities/1",
      "definitionName": "2nd address",
      "additionalAddress": "No. 13, street 123"
    }
  ],
  "language": "de",
  "corporateIdentificationNumber": "CHE-123.456.789",
  "foundingDate": "2019-12-20"
}

Changes

No recorded changes to this operation across all 1 revision of this API.