Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.signalhire.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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. Consumes profile credits. 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.

​
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.