Skip to Content
CompanySpec
API referenceCompany data

Get recent hires

GET
/companies/{company}/hires

People who recently joined the company, counted by department and seniority, plus the most recent hires (up to 100). Departments come from /values/hire_departments and seniorities from /values/hire_seniorities. No names or personal details are returned. Costs 1 lookup, free if the company is already paid for this billing month.

New hires usually appear 1–3 weeks after their start date.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.

Path Parameters

company*string

The company's domain (for example stripe.com) or its CompanySpec id (for example cmp_8f2k1).

Query Parameters

within_days?integer
Range1 <= value <= 365
Default90
department?string

A value from /values/hire_departments.

seniority?string

A value from /values/hire_seniorities.

Response Body

Recent hires.

application/json
  1. response
hires*
usage*

What this request cost and what is left this billing month.

Example Request
curl -X GET 'https://api.companyspec.com/v1/companies/acmedental.io/hires'
Example Response
{  "hires": {    "within_days": 90,    "total": 9,    "by_department": {      "engineering": 4,      "sales": 3,      "marketing": 2    },    "by_seniority": {      "senior": 3,      "mid": 4,      "executive": 1,      "entry": 1    },    "items": [      {        "department": "sales",        "seniority": "executive",        "start_date": "2026-10-06"      },      {        "department": "engineering",        "seniority": "senior",        "start_date": "2026-09-22"      }    ]  },  "usage": {    "charged": {      "lookups": 0,      "discoveries": 0    },    "already_paid": 1,    "remaining": {      "lookups": 9750,      "discoveries": 1977    }  }}

Get headcount GET

Current headcount by department, and total headcount per month for the last 12 months. Costs 1 lookup, free if the company is already paid for this billing month.

Get funding GET

Funding rounds, investors and acquisitions. Costs 1 lookup unless already paid for this billing month.