Companies

Get a company's team

Read which workspace members know the company's contacts (its Known by): for each active member, `known_contacts_count` (the company's contacts, any role, current or past, that the member is in the Kn

GET /v2/companies/{companyId}/team

Parameters

Path parameters

companyId
string (uuid) required

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.company_team
object required
data.company_team.members
array<object> required
data.company_team.members[].user_id
string required
data.company_team.members[].known_contacts_count
integer required
data.company_team.members[].last_interaction_at
string (date-time) required
data.company_team.you
object | null required
data.company_team.you.user_id
string required
data.company_team.you.known_contacts_count
integer required
data.company_team.you.last_interaction_at
string (date-time) required
data.company_team.you.last_private_note_at
string (date-time) required

Example

{
  "data": {
    "company_team": {
      "members": [
        {
          "user_id": "string",
          "known_contacts_count": 0,
          "last_interaction_at": "2026-10-27T17:27:24.892Z"
        }
      ],
      "you": {
        "user_id": "string",
        "known_contacts_count": 0,
        "last_interaction_at": "2026-10-27T17:27:24.892Z",
        "last_private_note_at": "2026-10-27T17:27:24.892Z"
      }
    }
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)
any

401 — Missing or invalid API key.

Content-Type: application/json

(body)
any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)
any

404 — Resource does not exist.

Content-Type: application/json

(body)
any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)
any

429 — Rate limit exceeded.

Content-Type: application/json

(body)
any

500 — Unexpected server error.

Content-Type: application/json

(body)
any

Code samples

curl https://api.prod.getdex.com/v2/companies/00000000-0000-0000-0000-000000000000/team \
  --header 'Authorization: Bearer YOUR_API_KEY'
Copyright © 2026