# Company shareholders

Canonical documentation: https://veripoint.ai/api-docs/kyb-shareholders

Retrieve available holdings, share classes, quantities and values for one company.

## Request

GET https://api.globaldatabase.com/v2/kyb/{id}/shareholders

This data API uses separately licensed credentials: Authorization: Token YOUR_DATA_API_KEY. It does not accept a Veripoint workspace key.

| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | Yes | Company ID returned by a company lookup. It is not the registration number. |
| page | query | integer | No | Page to retrieve. |
| per_page | query | integer | No | Records to return per page. No maximum is specified here in the source reference. |
| include_provenance | query | boolean | No | Include source metadata. Some endpoints also change their response structure. |

## Example

```curl
curl --fail-with-body --request GET 'https://api.globaldatabase.com/v2/kyb/YOUR_COMPANY_ID/shareholders?page=1&per_page=10' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json'
```

## Illustrative response

```json
{
  "data": [
    {
      "id": 123,
      "name": "EXAMPLE HOLDINGS LIMITED",
      "percentage": 100,
      "quantity": 100,
      "share_type": "ORDINARY",
      "currency": "GBP"
    }
  ],
  "total_pages": 1,
  "total_results": 1
}
```

Illustrative default excerpt. A missing percentage must not be inferred from the name or share class.

- Provenance adds a source object alongside the paginated results.
- A direct shareholder record does not, by itself, establish an ultimate beneficial owner.

Machine-readable reference: https://veripoint.ai/data-openapi.json