Get company employees
Returns the people Specter has on file for a company (founders and employees) as a list. Each row carries the person’s identity, socials, location, highlights and signal IDs alongside their role at the company; use person_id with Get person by ID for the full profile (experience, education, skills).
What you need
A Specter companyId in the path. If you only have a domain, website, or name, get the ID first with Find company ID (batch, free), or find it by name with Search entities by name.
Walk the results with page and limit.
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 signals by date.
Authorizations
Path Parameters
The Specter company ID.
Query Parameters
The number of results to return per page (minimum 1, maximum 50, default 50). A page is the unit these endpoints are priced in, so it cannot be widened beyond 50.
1 <= x <= 50The 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 person's first name.
"Cosmin"
The person's last name.
"Urdea"
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"
A url for a profile picture if there is one.
"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg"
URL for the person's LinkedIn account.
"https://www.linkedin.com/in/cosmin-urdea-0848973"
The numeric ID for the person's LinkedIn account.
11147428
URL for the person's Twitter account.
"https://x.com/moissinac"
URL for the person's GitHub account.
"https://github.com/sarahchen9776"
A short tagline for the person.
"Software Consultant / Contractor"
Where the person is located.
"Bucharest, București, Romania, Europe"
The person's own region — unrelated to the company's hq.
"Europe"
The person's highlights.
Talent signal IDs for this person. To read the signals themselves, call Get person talent signals rather than resolving these IDs individually.
Investor-interest signal IDs for this person. There is no per-person investor-interest endpoint; read these signals from the by-date feed.