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

department
enum<string> | null

Return only people in the given department. People departments enum

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

true returns only founders, false only non-founders; omit it for everyone.

ceo
boolean | null

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

key_people
boolean | null

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

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
integer
default:0

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

Required range: x >= 0

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
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>[] | null

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

People departments enum

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

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

Available options:
Executive Level,
Entry Level,
Other Level,
Mid Level,
Senior Level
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
integer | 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.