Skip to API documentation
veripoint
Login Start for free
Developer documentationAPI v2 + MCP
Request developer access
KYB / API REFERENCE

Search shareholdings

Find companies linked to an individual or corporate shareholder.

POST/kyb/shareholders/search/{view_mode}Official reference

Parameters

view_modepath · "lite" | "full"Required

lite returns the holder and linked company; full adds holding details. Permissions are separate for each mode.

namebody · stringRequired

Shareholder name, 2–500 characters.

company_namebody · stringOptional

Linked company name.

registration_numberbody · stringOptional

Linked company registration number.

vat_numberbody · stringOptional

Linked company VAT number.

location_countriesbody · string[]Optional

ISO two-letter country codes, for example ["GB"].

percentagebody · objectOptional

Optional gte and lte integers, each from 1 to 100.

pagebody · integerOptional

Default 1.

per_pagebody · integerOptional

Default 10; maximum 50.

include_provenancebody · booleanOptional

Include source metadata. Some endpoints also change their response structure.

Response

200 · application/json

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

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
}