# List an organisation's people

Everyone with a recorded role at the organisation, grouped as executives, professionals and alumni.

Canonical: https://chikaraintel.com/docs/api/reference/organisations/list-organisation-people

```text
GET https://api.chikaraintel.com/v1/organisations/{organisationReference}/people
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `organisationReference` (uuid, path, required) The organisation's reference.

## Response

The payload is under `success`.

- `current_executives` (array) Current staff whose title reads as executive.
- `current_professionals` (array) Everyone else currently there.
- `alumni` (array) Former staff, most recent leaver first.

Not paginated. Every person comes back in one response.

## Examples

cURL:

```bash
curl -sS "https://api.chikaraintel.com/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01/people" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json"
```

JavaScript:

```javascript
const BASE = "https://api.chikaraintel.com";
const headers = {
  Authorization: `Bearer ${process.env.CHIKARA_API_TOKEN}`,
  Accept: "application/json"
};

const res = await fetch(`${BASE}/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01/people`, { headers });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { success } = await res.json();
console.log(success);
```

Python:

```python
import os
import requests

BASE = "https://api.chikaraintel.com"
HEADERS = {
    "Authorization": f"Bearer {os.environ['CHIKARA_API_TOKEN']}",
    "Accept": "application/json",
}

res = requests.get(
    f"{BASE}/v1/organisations/3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01/people",
    headers=HEADERS,
    timeout=30,
)
res.raise_for_status()
print(res.json()["success"])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": {
    "current_executives": [
      {
        "reference": "a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341",
        "name": "Elena Marchetti",
        "first_name": "Elena",
        "last_name": "Marchetti",
        "linkedin_url": null,
        "confidence_score": 0.92,
        "role": {
          "title": "Chief Financial Officer",
          "organisation": "Halberd Industrial Group",
          "start_date": "2026-09-01",
          "end_date": null
        }
      }
    ],
    "current_professionals": [],
    "alumni": [
      {
        "reference": "b2c3d4e5-f6a7-4b8c-9d0e-f1a2b3c4d551",
        "name": "Tom Okonkwo",
        "first_name": "Tom",
        "last_name": "Okonkwo",
        "linkedin_url": null,
        "confidence_score": 0.88,
        "role": {
          "title": "Interim Chief Financial Officer",
          "organisation": "Halberd Industrial Group",
          "start_date": "2026-03-02",
          "end_date": "2026-08-31"
        }
      }
    ]
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```

## Used by

- get_company_people