Shareholders

Shareholders (cap table)

The current cap table: every holder by class and across all classes, % of shares and, where every class's voting rights are filed, % of votes, with the date of the shareholder list it comes from and links to the filings. Reconstructed from public filings at Companies House. The company's own register of members is the legal record. Every list is checked against a filed statement of capital: display says whether the table may be shown as fact, and discrepancies lists where the company's filings disagree. Allottees first seen on a later list are marked inferred in /history. Free keys get the top three holders, the holder count and top3_pct; every paid plan (API Starter, Business and Enterprise; web-app Pro and Team) gets everything. Returns 202 building while the first reconstruction runs (usually under a minute; companies with long histories take longer): call again after retry_after_seconds.

get/company/{number}/shareholders

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/company/{number}/shareholders
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

numberstring required

Companies House number (leading zeros may be omitted)

Response

Cap table

company_numberstring
status'ready' | 'updating'

updating: the newest list is in; the history is still being read

noticestring
display'fact' | 'flagged' | 'withheld'

fact: the latest shareholder list adds up to a filed statement of capital and nothing has changed since. flagged: shown with display_reasons; not to be presented as fact. withheld: the holders could not be reconstructed reliably and are not shown

display_reasonsstring[]
as_atstring date nullable

Date of the shareholder list the table comes from

confirmed_tostring date nullable

Latest confirmation statement saying nothing has changed since

built_atstring date-time
total_sharesnumber
votes_knownboolean
holder_countinteger nullable
top3_pctnumber nullable

% of all issued shares held by the three largest holders

limitedboolean

true: the top three holders only (free API keys and signed-out website visitors). Every paid plan (API Starter, Business and Enterprise; web-app Pro and Team) gets everything

by_classobject[]

Per class: holders with % of the class

pendingobject[]

Shares allotted, cancelled or reduced since the latest list, whose holders the company has not yet filed

discrepancy_countinteger

limited answers: how many places the filings disagree

movement_countinteger

limited answers: holdings that moved between lists in transfers the returns do not itemise (not a disagreement)

buildobject
rebuildingboolean
upgrade_urlstring uri

Example response

{
  "notice": "Reconstructed from public filings at Companies House. The company's own register of members is the legal record.",
  "source": {
    "form": "CS01"
  },
  "discrepancies": [
    {
      "source": {
        "form": "CS01"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.