# Search shareholdings

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

Find companies linked to an individual or corporate shareholder.

## Request

POST https://api.globaldatabase.com/v2/kyb/shareholders/search/{view_mode}

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 |
|---|---|---|---|---|
| view_mode | path | "lite" \| "full" | Yes | lite returns the holder and linked company; full adds holding details. Permissions are separate for each mode. |
| name | body | string | Yes | Shareholder name, 2–500 characters. |
| company_name | body | string | No | Linked company name. |
| registration_number | body | string | No | Linked company registration number. |
| vat_number | body | string | No | Linked company VAT number. |
| location_countries | body | string[] | No | ISO two-letter country codes, for example ["GB"]. |
| percentage | body | object | No | Optional gte and lte integers, each from 1 to 100. |
| page | body | integer | No | Default 1. |
| per_page | body | integer | No | Default 10; maximum 50. |
| include_provenance | body | boolean | No | Include source metadata. Some endpoints also change their response structure. |

## Example

```curl
curl --fail-with-body --request POST 'https://api.globaldatabase.com/v2/kyb/shareholders/search/lite' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example Holdings",
  "location_countries": [
    "GB"
  ],
  "page": 1,
  "per_page": 10
}'
```

## Illustrative response

```json
{
  "data": [
    {
      "name": "EXAMPLE HOLDINGS LIMITED",
      "type": "Company",
      "company": {
        "id": "12345678",
        "name": "EXAMPLE LIMITED",
        "registration_number": "01234567",
        "country_code": "GB"
      }
    }
  ],
  "total_pages": 1,
  "total_results": 1
}
```

Illustrative lite response excerpt. full adds percentage, quantity, share_type, share_price, share_value, currency, status, id and created.



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