Company Detail

This endpoint provides the data of a single company identified by HitHorizons ID.

GET /us/Company/Detail

Returns comprehensive company data including basic company information, financial and employee data, contact details, industry classification, company executives, and corporate structure.

Response Codes

200 OK 400 Bad Request 401 Unauthorized 404 Not Found 429 Too Many Requests

Try in Swagger UI →

Parameters

Parameter	Type	Description
`HitHorizonsId` required	string	A unique company identification number assigned by HitHorizons (e.g., H-USSD123456789)

Example Request

GET /us/Company/Detail?HitHorizonsId=H-USSD123456789
Ocp-Apim-Subscription-Key: your-api-key

Example Response

{
  "Success": true,
  "Error": null,
  "Result": {
    "HitHorizonsId": "H-USSD0001234567",
    "CompanyName": "Acme Manufacturing Corp, Ltd.",
    "DirectoryName": "Acme Manufacturing Corp",
    "CompanySecondaryName": null,
    "Address": {
      "Street1": "100 Industrial Way",
      "Street2": null,
      "PostalCode": "12345",
      "City": "Springfield",
      "CountyDistrict": "Example County",
      "StateProvince": "Texas",
      "Geo": {
        "GeoLevelDescription": "House",
        "Longitude": -100.123456,
        "Latitude": 35.123456,
        "GeoLevel": 7
      }
    },
    "NationalId": null,
    "NationalIdType": null,
    "CompanyType": 0,
    "LocationType": 2,
    "SalesLocal": 0,
    "LocalCurrency": null,
    "SalesUSD": 0,
    "SalesEUR": 0,
    "SalesAccuracyIndicator": 2,
    "EmployeesNumber": 50,
    "EmployeesNumberAccuracyIndicator": 3,
    "Contacts": {
      "Websites": [],
      "Phones": ["555 123 4567"],
      "Faxes": [],
      "Emails": [],
      "SocialURLs": []
    },
    "SIC": [
      {
        "IndustryText": "Manufacturing",
        "IndustryCode": "D",
        "SICText": "Mfg fiber cans/drums, etc",
        "SICCode": "2655"
      }
    ],
    "NACE": [
      {
        "NACEText": "Manufacture of corrugated paper and paperboard",
        "NACECode": "1721"
      }
    ],
    "LocalActivity": [],
    "SubsidiaryIndicator": 0,
    "CorporateStructure": {
      "DiasCode": "012345678",
      "HierarchyCode": 1,
      "NumberOfFamilyMembers": 2,
      "Relations": [
        {
          "RelationType": "Parent",
          "HitHorizonsID": null,
          "Name": "Acme Manufacturing Corp, Ltd.",
          "Address": {
            "Street1": "200 Corporate Blvd",
            "PostalCode": "77001",
            "City": "Houston"
          }
        }
      ]
    },
    "CEO": {
      "FullName": "Jane Doe",
      "Title": "Manager",
      "FirstName": "JANE",
      "LastName": "DOE"
    },
    "Executives": [
      {
        "FullName": "Jane Doe",
        "Title": "Office Manager",
        "FirstName": "JANE",
        "LastName": "DOE"
      }
    ],
    "HistoricalData": [
      {
        "SalesEUR": 0,
        "SalesUSD": 0,
        "Employees": null,
        "EmployeesLocal": 50,
        "Year": 2025
      }
    ],
    "DigitalCommerce": [],
    "AdditionalInformation": {
      "Language": "ENG",
      "ImportExportAgentCodeDescription": "None or Not Available",
      "MarketabilityIndicator": "M"
    }
  }
}

Response Fields

Root Level Fields

Field	Type	Description
`HitHorizonsId`	string	A unique company identification number assigned by HitHorizons (e.g., H-USSD123456789)
`CompanyName`	string	The registered business name of the company. Also known as BusinessName or FullName.
`DirectoryName`	string	The name to be published in directories (White and/or Yellow Pages). Also known as ListedName or ListingName.
`CompanySecondaryName`	string	The trade name or secondary name of the company. Also known as TradeName or TradeStyle (Doing business as).
`NationalId`	string	National identification number of the company.
`NationalIdType`	string	National identification number type code, as it can be different per country.
`EstablishmentOfOwnership`	integer	Setup year of the business.
`CompanyType`	integer	Code that identifies the legal status/structure of the business. Values: 0 = Not Available, 3 = Corporation, 12 = Partnership, 13 = Proprietorship.
`LocationType`	integer	Code that provides business location type. Values: 0 = Single location, 1 = Headquarter/Parent, 2 = Branch.

Financial Data Fields

Field	Type	Description
`SalesLocal`	double	Sales value for the business in local currency. Can be consolidated or non-consolidated figure.
`LocalCurrency`	string	Code indicating which currency the financial figures data (Sales) is represented in.
`SalesUSD`	double	Sales value for the business in US dollars. Values are converted based on the date of the financial statement.
`SalesEUR`	double	Sales volume in EUR currency.
`SalesAccuracyIndicator`	integer	Sales volume Sales volume reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.

Employee Data Fields

Field	Type	Description
`EmployeesNumber`	integer	The number of employees.
`EmployeesNumberAccuracyIndicator`	integer	Employees reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`EmployeesNumberLocal`	integer	The number of employees at this location.
`EmployeesNumberLocalAccuracyIndicator`	integer	Employees here reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`EmployeesNumberTotal`	integer	The total number of employees in the business organization. Can be consolidated or non-consolidated.
`EmployeesNumberTotalAccuracyIndicator`	integer	Employees total reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.

Address Object

Field	Type	Description
`Street1`	string	Name of the street and house number (Address line 1).
`Street2`	string	Name of the street and house number (Address line 2).
`PostalCode`	string	Postal code / ZIP code.
`City`	string	Name of the city.
`CountyDistrict`	string	Name of the county or district.
`StateProvince`	string	Name of the state or province.
`Geo`	object	Geolocation data (see Geolocation Object below).

Geolocation Object (Address.Geo)

Field	Type	Description
`Longitude`	double	Geographic longitude coordinate.
`Latitude`	double	Geographic latitude coordinate.
`GeoLevel`	integer	Geocoding accuracy level (1-9).
`GeoLevelDescription`	string	Description of geocoding level. Values: 1 = Country, 2 = State, 3 = City, 4 = PostalCode, 5 = District, 6 = Street, 7 = House, 8 = AddressPoint, 9 = RoofTop (highest accuracy).
`BuildingName`	string	Name of the building (if available).
`BuildingType`	string	Type of building.
`BuildingGeom`	string	Building geometry data.
`BuildingArea`	double	Building area in square meters.
`LastUpdate`	string	Date of last geolocation update.

Contacts Object

Field	Type	Description
`Websites`	string[]	Website addresses / URLs of the company.
`Phones`	string[]	Telephone or mobile phone numbers.
`Faxes`	string[]	Fax numbers.
`Emails`	string[]	Email addresses.
`SocialURLs`	object[]	Social media URLs (see SocialURL Object below).

SocialURL Object (Contacts.SocialURLs[])

Field	Type	Description
`Type`	string	The type of social media platform. Values: l = LinkedIn, c = Facebook, x = X. Values can be found in CodeLists.
`URL`	string	The URL of the company's profile on the specified social media platform.

SIC Activity Code Object (SIC[])

Field	Type	Description
`SICCode`	string	Standard Industrial Classification (SIC) code - a 4-digit code used to classify business activities.
`SICText`	string	Description of the SIC code.
`IndustryCode`	string	Industry classification code (A-J).
`IndustryText`	string	Description of the industry classification.

NACE Activity Code Object (NACE[])

Field	Type	Description
`NACECode`	string	NACE business classification code.
`NACEText`	string	Description of the NACE business classification.

Local Activity Code Object (LocalActivity[])

Field	Type	Description
`LocalActivityCode`	string	The local industry classification code (e.g., NAICS code for US).
`LocalActivityText`	string	Description of the local business activity classification.
`LocalActivityCodeType`	string	This indicator identifies which activity code type is provided (e.g., "112" for NAICS).

Corporate Structure Object

Field	Type	Description
`SubsidiaryIndicator`	integer	Indicator whether this company is a subsidiary. Values: 0 = not a subsidiary, 3 = is a subsidiary, blank = unlinked. Note: branches always carry 0.
`DiasCode`	string	Nine-digit numeric sort key used to group records belonging to the same corporate family. This value is derived and may change, so it should not be used as a stable join key.
`HierarchyCode`	integer	Two-digit depth indicator within the corporate family tree. Values: 01 = ultimate parent, 02, 03, etc. = progressively deeper levels. Branches inherit the hierarchy level of their headquarters.
`NumberOfFamilyMembers`	integer	The number of family members including the global ultimate and all subsidiaries and branches worldwide. Every family member carries the same count.
`Relations`	object[]	Array of corporate relationships (see Relation Object below).

Relation Object (CorporateStructure.Relations[])

Field	Type	Description
`RelationType`	string	Type of relationship: "Parent" (Parent/Headquarter organization), "Domestic Ultimate" (highest-level parent within the same country), or "Global Ultimate" (highest-level parent worldwide).
`HitHorizonsID`	string	HitHorizons unique identification number of the related company.
`Name`	string	Business name of the related company.
`Address`	object	Address of the related company (same structure as main Address object).

Person Object (CEO, Executives[])

Field	Type	Description
`FullName`	string	The full name of the person.
`Title`	string	The title of the person (e.g., CEO, President). May be abbreviated.
`FirstName`	string	The first name of the person.
`LastName`	string	The last name of the person.

Historical Data Object (HistoricalData[])

Field	Type	Description
`Year`	integer	The year for which the historical data applies.
`SalesEUR`	long	Sales volume in EUR currency.
`SalesUSD`	long	Sales volume in USD currency.
`SalesLocal`	long	Sales value in local currency.
`SalesIndicator`	integer	Sales reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`Currency`	string	Currency code for financial figures.
`Employees`	integer	Calculated number of employees.
`EmployeesIndicator`	integer	Employees reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`EmployeesLocal`	integer	The number of employees at this location.
`EmployeesLocalIndicator`	integer	Employees here reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`EmployeesTotal`	integer	The total number of employees in the organization.
`EmployeesTotalIndicator`	integer	Employees total reliability code. Values: 0 = Accurate, 1 = Low end of a range, 2 = Estimated, 3 = Modeled, 9 = Derived.
`Other`	object	Additional historical data fields including FamilyMembers count and Version identifier.

Digital Commerce Object (DigitalCommerce[])

Field	Type	Description
`Shop`	string	E-commerce platform used (e.g., shopify, magento, woocommerce, bigcommerce, prestashop).
`OtherShop`	string	Review and/or rating website tools (e.g., trustami, trustedShops, backInStock).
`PaymentProvider`	string	Payment provider used (e.g., stripe, paypal, klarna, adyen, braintree, square).
`SimplePaymentRule`	string	Payment method accepted (e.g., visa, mastercard, amex, applepay, googlepay, venmo).
`MarketingAutomation`	string	Marketing automation tool used (e.g., mailchimp, hubspot, klaviyo, activeCampaign, marketo).

Additional Information Object

Field	Type	Description
`Language`	string	Language code (e.g., "ENG").
`ImportExportAgentCodeDescription`	string	Description of import/export agent code (e.g., "None or Not Available").
`MarketabilityIndicator`	string	Marketability indicator code.
`UniversalPublicationId`	string	Universal publication identifier.
`IsPublished`	string	Whether the company is published.
`PublishingStrength`	string	Publishing strength indicator.
`OpeningHours`	string	Business opening hours.

Tip

Use the Code Lists endpoint to get human-readable descriptions for coded values like CompanyType, LocationType, and accuracy indicators.