The company info API call returns information about company resources.

Syntax	…/svc/2.0/info/companydomain/<id>
Example	…/svc/2.0/info/companydomain/bar.com
Parameter	An ID (domain name) as the last part of the URL

The company domain resources contain descriptions that are language-specific, the economic classifications. To get these descriptions in a specific language, add a HTTP Accept-language header to the request. The service will then return the descriptions in the requested language, if available, otherwise in the default language defined for each schema.

Result

<companyDomainInfo>
    <id>bar.com</id>
    <orgName>Bar.Com GmbH</orgName>
    <addressStreet>Barstrasse 11</addressStreet>
    <addressCity>Neumarkt</addressCity>
    <addressZipCode>92318</addressZipCode>
    <addressLatitude>11.000001</addressLatitude>
    <addressLongitude>49.111110</addressLongitude>
    <countryCode>de</countryCode>
    <classifications>
        <classification>
            <id>34.10</id>
            <description>Herstellung von Kraftwagen und Kraftwagenteilen</description>
            <lang>de</lang>
            <type>wz2003</type>
        </classification>
    </ classifications>
<companyDomainInfo>

or

{
     "id":"bar.com",
     "orgName":"Bar.Com GmbH",
     "addressStreet":"Barstrasse 11",
     "addressCity":"Neumarkt",
     "addressZipCode":"92318",
     "countryCode": "de",
     "addressLatitude": 11.000001,
     "addressLongitude": 49.111110,
     "classifications": [
        {"id":"34","text":"Herstellung von Kraftwagen und Kraftwagenteilen", "type": "wz2003", "lang": "de"}
     ]
}

The structure of the result document is:

• id: the ID of the resource, which is also the domain name representing the company
• orgName: the name of the company
• addressStreet/City/ZipCode: postal address data for the company
• countryCode: ISO 639-1 country code for the address
• addressLatitude/Longitude: geographic coordinates for the company address
• classifications: zero or more economic classification entries describing the area of economic activity for this company
  • id: ID of the classification entry accoding to the schema used
  • type: the classification schema used in this entry, possible values:
    • wz2003: older German classification, see Klassifikation der Wirtschaftszweige, Ausgabe 2003
    • wz2008: recent German classification, see Klassifikation der Wirtschaftszweige, Ausgabe 2008
    • nace2: EU classification, see NACE Rev. 2 – Statistical classification of eceonomic activities
    • isic4: UN classification, see International Standard Industrial Classification of All Economic Activities, Rev.4
  • lang: language code for the description; can be influenced by the Accept-language header, see above;
  • description: descriptive text for the classification entry, available in various languages

Functionality

The service looks up the ID in the company_domain table, adds the economic classifications via the company_domain_classification and economic_classification tables, and returns the combined result. If no data is available for an ID the server will signal this with HTTP response code 204 (No Content) and return no result (null).

The descriptive texts for the economic classifications are read from static property files. These are available in different languages. The service will try to find the best match for the language specified in the Accept-language header, or fall back to a default language if it cannot.

The available language editions are:

• wz2003: default = de, available = de
• wz2008: default = en, available = de, en
• nace2: default = en, available = bg, cs, da, de, el, en, es, et, fi, fr, hu, it, lt, lv, mt, nl, no, pl, pt, ro, ru, sk, sl, sv, tr
• isic4: default = en, available = en, es, fr

Each execution of the call will be documented as a business event (database table business_event) with type 120.

Please note that a company domain entity contains three items that are reserved for future use:

• legal form: the name of the company’s legal form
• staff: the number of people working for it
• revenue: some revenue number

These items are fully integrated but there is currently no data available in the static company table, so they will not appear in the output.