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
number

The number of results to return, default is 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

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"