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

Company shareholders

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

GET/kyb/{id}/shareholdersOfficial reference

Parameters

idpath · integerRequired

Company ID returned by a company lookup. It is not the registration number.

pagequery · integerOptional

Page to retrieve.

per_pagequery · integerOptional

Records to return per page. No maximum is specified here in the source reference.

include_provenancequery · booleanOptional

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

Working with this response

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

Response

200 · application/json

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

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