Get company employees
Returns the people Specter has on file for a company (founders and employees) as a list. Use each person_id with Get person by ID to pull a full profile.
What you need
A Specter companyId (via Find company ID or Search company name).
Behaviour
- Returns at most 100 people per request (default 50).
- Narrow results with
founders,ceo,key_people, anddepartment; these filters can be combined. - Page through large teams with
limitandpage(pageis zero-based). - Returns
404if the company ID doesn’t exist.
What you do next
- Profile a person. Follow a person’s
person_idto Get person by ID. - Get their email. Pull a contactable address with Get person email.
- Watch their moves. Follow a person’s
talent_signal_idsto Get Talent Signal by ID.
Authorizations
Path Parameters
The Specter company ID.
Query Parameters
The number of results to return, default is 50.
The page number of results to return, base 0, default is 0.
Return only founders.
Return only CEOs (a company can have more than one).
Return only key people (CEO, CTO, CFO, COO, and current or past founders).
Return only people in the given department.
BD & Marketing, Engineering, Finance, Human Resources, Legal & Compliance, Operations, Product & Research, Senior Leadership, Strategy & Corporate Development, Other Response
The people who work at the company.
The person's Specter ID, usable on the people endpoints (may be null for legacy records).
"per_34f8a8ad1f7497b83e821345"
The person's full name.
"Cosmin Urdea"
The person's job title (may be null).
"(valantic mandate / partnership) Stripe Integration Engineer"
Whether the person is a founder.
false
The departments the person belongs to (may be empty).
BD & Marketing, Engineering, Finance, Human Resources, Legal & Compliance, Operations, Product & Research, Senior Leadership, Strategy & Corporate Development, Other The person's seniority level (may be null).
"Mid Level"