Skip to main content
GET
/
network
/
connection
/
{companyId}
Get your team's network at a company
curl --request GET \
  --url https://app.tryspecter.com/api/v1/network/connection/{companyId} \
  --header 'X-API-Key: <api-key>'
{
  "company_id": "66d926166261234567890123",
  "contacts": [
    {
      "person_id": "per_5f3a2b1c4d5e6f7a8b9c0d1e",
      "connected_teammates": [
        "user_2opva2jahltnNL8xOK7vArM0IBg"
      ],
      "full_name": "Jane Doe",
      "headline": "Engineering Lead @ Acme · ex-Google",
      "profile_picture_url": "https://media.licdn.com/dms/image/.../profile.jpg",
      "linkedin_url": "https://linkedin.com/in/janedoe",
      "twitter_url": "https://twitter.com/janedoe",
      "github_url": "https://github.com/janedoe"
    }
  ],
  "roles": [
    "engineer",
    "founder"
  ],
  "connected_teammates": [
    "user_2opva2jahltnNL8xOK7vArM0IBg"
  ]
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
company_id
string
required

The Specter company id.

Response

Your team's network connections at a specific company.

Your team's network presence at a single company - who you know there, their roles, and which teammates are connected to them.

​
company_id
string
required

The Specter company id of the queried company.

Example:

"66d926166261234567890123"

​
contacts
NetworkContact · object[]
required

People in your team's network who currently work at this company.

​
roles
string[]
required

Distinct role classifications across all contacts at this company (e.g. engineer, founder). Useful for filtering or summarising the type of relationship the org has at this company.

Example:
["engineer", "founder"]
​
connected_teammates
string[]
required

Internal Specter user IDs of all teammates who hold at least one connection at this company.

Example:
["user_2opva2jahltnNL8xOK7vArM0IBg"]