> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.endole.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Shareholders

Retrieve official shareholder records for a company, including confirmation dates, share classes, number of shares held, currency, issued capital, and ownership percentages.

<Callout icon="coins" iconType="regular">
  **Cost:** 20 credits per request
</Callout>

## Endpoint

```http theme={null}
GET https://api.endole.co.uk/company/{company_number}/shareholders
```

## Parameters

| Parameter | Required | Description |
| - | - | - |
| company\_number | Yes | The 8-character official UK Companies House registration number. |

## Example Request

```shellscript theme={null}
curl -X GET "https://api.endole.co.uk/company/00002065/shareholders" \
  -H "Authorization: Bearer 33e2ea54ca6d9ce3f70b24a4e13d9cf9a451c51f1f2140d21e8e2131cd37fcc"
```

## Example Response

```json theme={null}
{
  "status": "success",
  "company_number": "00002065",
  "data": {
    "shareholders": {
      "total_shares": "1500",
      "confirmation_date": "2026-05-06",
      "issued_capital": "1500",
      "issued_capital_currency": "GBP",
      "pagination": {
        "page": "1",
        "per_page": "10",
        "total_items": "2",
        "total_pages": "1"
      },
      "items": [
        {
          "name": "Lloyds Banking Group Plc",
          "type": "Corporate",
          "share_class": "Redeemable preference",
          "shares_held": "822",
          "ownership_percentage": "54.8"
        },
        {
          "name": "John Smith",
          "type": "Individual",
          "share_class": "Ordinary",
          "shares_held": "678",
          "ownership_percentage": "45.2"
        }
      ]
    }
  }
}
```