# List a profile's ownership

The stakes a person holds in organisations.

Canonical: https://chikaraintel.com/docs/api/reference/profiles/list-profile-ownership

```text
GET https://api.chikaraintel.com/v1/profiles/{profileReference}/ownership
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `profileReference` (uuid, path, required) The person's reference.

## Response

The payload is under `success`.

- `organisation` (object) `{ reference, name }`
- `ownershipType` (string) A label, such as `Share Ownership`.
- `ownershipPercentage` (string) A band, such as `25% but less than 50%`.
- `titleOrStatus` (string | null) The person's title at the organisation.
- `isControlPerson` (boolean)
- `isActive` (boolean)
- `startDate` (date | null)
- `endDate` (date | null)

Returns an empty array, not a 404, when the person holds no recorded stakes or the reference is unknown.

## Examples

cURL:

```bash
curl -sS "https://api.chikaraintel.com/v1/profiles/d4e5f6a7-b8c9-4d0e-9f2a-b3c4d5e6f771/ownership" \
  -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/profiles/d4e5f6a7-b8c9-4d0e-9f2a-b3c4d5e6f771/ownership`, { 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/profiles/d4e5f6a7-b8c9-4d0e-9f2a-b3c4d5e6f771/ownership",
    headers=HEADERS,
    timeout=30,
)
res.raise_for_status()
print(res.json()["success"])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": [
    {
      "organisation": {
        "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
        "name": "Halberd Industrial Group"
      },
      "ownershipType": "Share Ownership",
      "ownershipPercentage": "Less than 5%",
      "titleOrStatus": "Chair",
      "isControlPerson": true,
      "isActive": true,
      "startDate": "2021-05-12",
      "endDate": null
    }
  ],
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```

## Used by

- get_person