Skip to main content
Some countries don’t expose shareholder data directly through official registries. For these countries, Topograph offers a shareholders datapoint that reconstructs the most probable current shareholder structure by analyzing available company documents. The output format is identical to shareholders returned in companyProfile for countries with direct registry access (e.g., Germany, Spain).
Alpha Feature — Best Effort ReconstructionThis feature reconstructs a plausible shareholder structure based on available public documents. Due to the nature of incomplete public records, we cannot guarantee that:
  • All shareholders are captured — some may be missing if not disclosed in available documents
  • No extra shareholders appear — historical shareholders may be included if no exit was recorded
  • Share amounts are exact — percentages and share counts are approximations based on available data
This is a best-effort reconstruction, not authoritative registry data. Results should be verified manually for compliance or legal use cases.Additional alpha limitations:
  • Processing may take 30 seconds to several minutes
  • Extraction may fail or return no results for some companies
  • Behavior and pricing may change

​
Supported Countries

CountryCodePrice
FranceFR€2.00
United KingdomGB€2.00
BelgiumBE€2.00

​
Example Request

curl --request POST \
  --url https://api.topograph.co/v2/company \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "countryCode": "FR",
    "id": "123456789",
    "dataPoints": ["shareholders"]
  }'

​
Example Response

The response uses the same shareholders structure as countries with direct registry access: 
{
  "request": {
    "requestId": "uuid-v4",
    "companyId": "123456789",
    "country": "FR",
    "dataStatus": {
      "dataPoints": {
        "shareholders": {
          "status": "succeeded",
          "cost": 200
        }
      }
    }
  },
  "shareholders": [
    {
      "type": "individual",
      "individual": {
        "name": {
          "fullName": "Jean Dupont"
        }
      },
      "sharePercentage": 60,
      "numberOfShares": 600
    },
    {
      "type": "company",
      "company": {
        "legalName": "Holding SAS",
        "countryCode": "FR",
        "registrationNumber": "987654321"
      },
      "sharePercentage": 40,
      "numberOfShares": 400
    }
  ]
}

​
Best Practices

This is a best-effort reconstruction. Use the data for initial research or screening, but verify through official channels for compliance decisions.
Use alongside ultimateBeneficialOwners for a more complete ownership picture. UBOs come from official registers where available.