Company Suggestions

This endpoint allows you to search for companies using a company name. If fewer companies than specified are found, results of company name suggestions are returned. This is useful for populating dropdown selectors for autocomplete scenarios.

GET /us/Company/Suggestions

Returns a list of company suggestions matching the query including basic company information, location information, and national ID (if available).

Response Codes

200 OK 400 Bad Request 401 Unauthorized 429 Too Many Requests

Try in Swagger UI →

Parameters

Parameter	Type	Description
`Query` required	string	Company name query. Minimum length is 3 characters.
`SkipSuggestions`	boolean	When `true`, only existing companies will be returned. No suggestions will be added when fewer than MaxResults companies are found. Useful for faster responses. Default: `false`
`MaxResults`	integer	Maximum number of results to return. Maximum of 20 results is supported. Default: 20

Example Request

GET /us/Company/Suggestions?Query=Acme&MaxResults=10
Ocp-Apim-Subscription-Key: your-api-key

Example with SkipSuggestions

GET /us/Company/Suggestions?Query=Acme&SkipSuggestions=true&MaxResults=10
Ocp-Apim-Subscription-Key: your-api-key

Example Response

{
  "Success": true,
  "Error": null,
  "Result": [
    {
      "HitHorizonsId": "H-USSD0001234567",
      "Name": "Acme Corp",
      "PostalCode": "12345",
      "CountyDistrict": "Example County",
      "StateProvince": "Texas",
      "NationalId": null
    },
    {
      "HitHorizonsId": "H-USSD0009876543",
      "Name": "Acme Industries, L.P.",
      "PostalCode": "67890",
      "CountyDistrict": "Sample County",
      "StateProvince": "California",
      "NationalId": "0001234567"
    }
  ]
}

Response Fields

Each suggestion includes:

HitHorizonsId - Unique identifier for retrieving full details
Name - Company name
PostalCode - Postal/ZIP code
CountyDistrict - County or district
StateProvince - State or province
NationalId - National registration ID (if available)

Use Cases

Autocomplete dropdowns - Type-ahead search for company names
Company selection forms - Help users find and select companies quickly
Search interfaces - Power search boxes in your application

Performance Tip

Set SkipSuggestions=true when you need faster response times.