FeaturesManage Cap TableView Cap Table

View Cap Table

Use this page when you want to answer one question: who currently holds stock for this issuer?

Send a GET request

GET http://localhost:8293/cap-table/holdings/stock?issuerId=<YOUR_ISSUER_ID>

Check the response

The response returns:

  • holdings - active stock positions only
  • stockClasses - stock classes for the issuer
  • issuer - the issuer record
{
    "holdings": [
        {
            "stockClass": {
                "_id": "<YOUR_STOCK_CLASS_ID>"
            },
            "stakeholder": {
                "_id": "<YOUR_STAKEHOLDER_ID>"
            },
            "quantity": 100000,
            "sharePrice": 4.2,
            "timestamp": 1767225600
        }
    ],
    "stockClasses": [
        {
            "_id": "<YOUR_STOCK_CLASS_ID>"
        }
    ],
    "issuer": {
        "_id": "<YOUR_ISSUER_ID>"
    }
}

This route returns active stock positions only. It does not show option, warrant, or convertible positions.

What this route answers

  • which stock positions are still active
  • which stock classes belong to the issuer
  • which issuer record the holdings belong to

What is excluded

  • positions with zero remaining quantity
  • non-stock instruments

How to read the result

  • use holdings to see the active stock positions
  • use stockClasses to map those holdings back to the stock classes
  • use issuer to confirm you are looking at the right cap table

What’s next?

Use this page for the current state. Use View History when you want to see how the cap table got to that state.

Issue and Accept StockCorporate Actions