---
title: "Person Colleagues"
description: "Find current colleagues of a person at their current company."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.kooperativa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Person Colleagues

`GET /api/v1/person/colleagues`

Returns current colleagues, meaning other people who currently work at the same company as the given person.

:::tip
Great for multi-threading outreach. Once you know one contact at a company, find their colleagues to reach multiple stakeholders simultaneously.
:::

## Query parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `id` | string | **Yes** | Kooperativa internal profile ID |
| `page` | integer | No | Page number (default: 1) |
| `per_page` | integer | No | Results per page (default: 10, max: 50) |

:::note
This endpoint requires a Kooperativa internal `id`. Get it from [Enrich Person](/people/enrich-person) first.
:::

## Code examples

```bash title="cURL"
curl "https://kooperativa.io/api/v1/person/colleagues?id=f9413465-c1b9-4129-ab9f-2234caf971b1" \
  -H "Authorization: Bearer ik_live_..."
```

```js title="JavaScript"
const res = await fetch(
  "https://kooperativa.io/api/v1/person/colleagues?id=f9413465-c1b9-4129-ab9f-2234caf971b1",
  { headers: { Authorization: `Bearer ${process.env.KOOPERATIVA_API_KEY}` } }
);
const data = await res.json();
```

## Response

```json
{
  "id": "f9413465-...",
  "company_id": "1035",
  "company_name": "Microsoft",
  "colleagues": [
{
  "id": "a1b2c3d4-...",
  "full_name": "Brad Smith",
  "current_title": "Vice Chair and President",
  "linkedin_url": "https://www.linkedin.com/in/bradsmith"
}
  ],
  "total": 231464,
  "page": 1,
  "per_page": 10
}
```

Source: https://docs.kooperativa.io/people/person-colleagues/index.mdx