Skip to main content
GET
/
companies
/
{companyId}
/
people
Get company people
curl --request GET \
  --url https://app.tryspecter.com/api/v1/companies/{companyId}/people \
  --header 'X-API-Key: <api-key>'
[
  {
    "person_id": "per_3423df234f3f32f",
    "full_name": "Sarah Chen",
    "title": null,
    "is_founder": false,
    "departments": [
      [
        "Engineering",
        "Senior Leadership"
      ]
    ],
    "seniority": "Executive Level"
  }
]

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
companyId
string
required

The ID of the company being requested

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

Filters the people to only return the founders

​
ceo
boolean

Filters the people to only return the CEOs

​
department
enum<string>

Filters the people to only return those in the department specified

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

Response

The list of companies IDs

​
person_id
string

The Person ID for the team member which can be used on the people endpoints.

Example:

"per_3423df234f3f32f"

​
full_name
string

The full name of the team member

Example:

"Sarah Chen"

​
title
string

The title in the role the person has

Example:

null

​
is_founder
boolean

If the team member is a founder or not

Example:

false

​
departments
enum<string>[]

The departments the person is in

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

The level of seniority that the team member has.

Example:

"Executive Level"