Skip to main content
The Company Profiles API consists of two endpoints: one to check the available profile count for a company, and one to retrieve those profiles via an async callback. This is particularly useful when needing to fetch all employees of a specific company by its exact ID or slug — unlike the Search API which filters by company name (a non-unique string), this endpoint works with the unique LinkedIn company ID or slug from Find Company.

​
Get Profile Count

Check how many profiles are associated with a company by employment status — no credits consumed. Endpoint: GET https://www.signalhire.com/api/v1/company/getCount
​
apikey
string
required
Secret API key.
​
id
string
required
Company ID (numeric) or company slug.
​
status
string
required
Employment status filter. Possible values: current, past, both.

​
Request Example

curl -X GET \
  -H 'apikey: your_secret_api_key' \
  'https://www.signalhire.com/api/v1/company/getCount?id=1033&status=both'

​
Response Example (HTTP 200)

{
  "total_profiles": 2,
  "profiles_credits_available": 50,
  "contacts_credits_available": 200
}
​
total_profiles
integer
Total number of profiles matching the status filter.
​
profiles_credits_available
integer
Available profile credits for fetching these profiles.
​
contacts_credits_available
integer
Available standard credits for enriching contacts.

​
Get Profiles

Fetch employee profiles for a company asynchronously via callback. Endpoint: GET https://www.signalhire.com/api/v1/company/getProfiles
​
apikey
string
required
Secret API key.
​
id
string
required
Company ID (numeric) or company slug.
​
status
string
required
Employment status filter. Possible values: current, past, both.
​
callbackUrl
string
required
URL where results will be POSTed once processing is complete. Same callback format and delivery rules as Person API callbacks.

​
How It Works

  1. The request returns a searchId immediately with HTTP 200
  2. Profiles are delivered to the callbackUrl in batches of up to 100 profiles per callback
  3. Each profile delivered consumes 1 profile credit — a separate credit type specific to this endpoint
  4. Profiles are returned without contact details (no emails or phone numbers) To subsequently retrieve contact details for specific profiles, pass their uid values to the Person API, which consumes standard credits.

​
Request Example

curl -X GET \
  -H 'apikey: your_secret_api_key' \
  'https://www.signalhire.com/api/v1/company/getProfiles?id=accenture&status=both&callbackUrl=https://yourdomain.com/callback'

​
Response Example (HTTP 200)

{
  "searchId": 1
}
Results are delivered to the callbackUrl as an array of profile objects without contact details.

​
Response Codes

CodeDescription
200Request accepted. Results will be sent to callbackUrl.
402Not enough profile credits.
403Company API access not enabled for this account.