Skip to main content
GET
Get company employees

Authorizations

X-API-Key
string
header
required

Path Parameters

companyId
string
required

The Specter company ID.

Query Parameters

limit
integer
default:50

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.

Required range: 1 <= x <= 50
page
number

The page number of results to return, base 0, default is 0.

founders
boolean

Return only founders.

ceo
boolean

Return only CEOs (a company can have more than one).

key_people
boolean

Return only key people (CEO, CTO, CFO, COO, and current or past founders).

department
enum<string>

Return only people in the given department.

Available options:
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.

person_id
string | null
required

The person's Specter ID, usable on the people endpoints (may be null for legacy records).

Example:

"per_34f8a8ad1f7497b83e821345"

full_name
string
required

The person's full name.

Example:

"Cosmin Urdea"

title
string | null
required

The person's job title (may be null).

Example:

"(valantic mandate / partnership) Stripe Integration Engineer"

is_founder
boolean
required

Whether the person is a founder.

Example:

false

first_name
string | null

The person's first name.

Example:

"Cosmin"

last_name
string | null

The person's last name.

Example:

"Urdea"

departments
enum<string>[]

The departments the person belongs to (may be empty).

Available options:
BD & Marketing,
Engineering,
Finance,
Human Resources,
Legal & Compliance,
Operations,
Product & Research,
Senior Leadership,
Strategy & Corporate Development,
Other
Example:
seniority
string | null

The person's seniority level (may be null).

Example:

"Mid Level"

profile_picture_url
string | null

A url for a profile picture if there is one.

Example:

"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg"

linkedin_url
string | null

URL for the person's LinkedIn account.

Example:

"https://www.linkedin.com/in/cosmin-urdea-0848973"

linkedin_num_id
number | null

The numeric ID for the person's LinkedIn account.

Example:

11147428

twitter_url
string | null

URL for the person's Twitter account.

Example:

"https://x.com/moissinac"

github_url
string | null

URL for the person's GitHub account.

Example:

"https://github.com/sarahchen9776"

tagline
string | null

A short tagline for the person.

Example:

"Software Consultant / Contractor"

location
string | null

Where the person is located.

Example:

"Bucharest, București, Romania, Europe"

region
string | null

The person's own region — unrelated to the company's hq.

Example:

"Europe"

highlights
string[] | null

The person's highlights.

Example:
talent_signal_ids
string[] | null

Talent signal IDs for this person. To read the signals themselves, call Get person talent signals rather than resolving these IDs individually.

investor_signal_ids
string[] | null

Investor-interest signal IDs for this person. There is no per-person investor-interest endpoint; read these signals from the by-date feed.