Company Search

This endpoint allows you to search the company database using a structured query.

GET /us/Company/Search

Returns a list of companies matching the search criteria including basic company information, financial data, employee count, industry classification, company and location type, and contact details.

Response Codes

200 OK 400 Bad Request 401 Unauthorized 429 Too Many Requests
Try in Swagger UI →

Important Note

Default search includes partnerships, corporations, and proprietorships. For other company types or branches, manual selection is required. Ensure to adjust these settings according to your specific search requirements.

Parameters

Parameter Type Description
CompanyName string Official name of the company
CompanyNameExact string Query to search for exact company name
NationalId string Company identification number officially assigned and used for company incorporation and tax collection
AddressUnstructured string Query to search for in the company address
AddressStreet string Query to search for in the company street address
PostalCode string Query to search for in the company postal code
City string Query to search for in the company city
CountyDistrict string Query to search for in the company county/district
StateProvince string Query to search for in the company state/province (e.g., "Texas", "California")
CompanyTypes string[] Array of company types to return. When not supplied, only types 0, 3, 12, 13 are returned. Refer to Code Lists for values. If set to empty value, all company types are returned.
ShowBranches boolean When false (default), only single-location or headquarters are returned (LocationType = 0 or 1). When true, all companies including branches are returned.
Website string Query to search for in company websites
Email string Query to search for in company email contacts
Phone string Query to search for in company phone contacts
SocialUrl string Query to search for in any company social media URLs (LinkedIn, Facebook, X). To search within a specific platform, include the platform name in your query, e.g., "linkedin acme"
MaxResults integer Maximum number of results to return (optional)

Example Request

GET /us/Company/Search?CompanyName=Acme&StateProvince=Texas&ShowBranches=false&MaxResults=20
Ocp-Apim-Subscription-Key: your-api-key

Example with Array Parameters

GET /us/Company/Search?CompanyName=Acme&CompanyTypes=3&CompanyTypes=13&MaxResults=20
Ocp-Apim-Subscription-Key: your-api-key

Example Response

{
  "Success": true,
  "Error": null,
  "Result": {
    "Results": [
      {
        "HitHorizonsId": "H-USSD0001234567",
        "CompanyName": "Acme Manufacturing Corp",
        "CompanySecondaryName": null,
        "AddressStreetLine1": "100 Industrial Way",
        "AddressStreetLine2": null,
        "PostalCode": "12345",
        "City": "Springfield",
        "CountyDistrict": "Example County",
        "StateProvince": "Texas",
        "NationalId": "0001234567",
        "SICCode": "2655",
        "IndustryCode": "D",
        "EstablishmentOfOwnership": 1995,
        "SalesEUR": 50000,
        "SalesUSD": 54000,
        "EmployeesNumber": 50,
        "CompanyType": 3,
        "LocationType": 0,
        "Websites": null,
        "Emails": null,
        "Phones": ["555 123 4567"],
        "SocialURLs": null
      }
    ],
    "ResultsCount": 20,
    "TotalCount": 1953
  }
}

Response Fields

Results Array

Each company in the results array includes:

Pagination Info

Tip

Use the HitHorizonsId from search results with the Detail endpoint to retrieve comprehensive company information.