API reference / Shareholding
Shareholding
Retrieve promoter, public and institutional ownership snapshots.
Overview
Shareholding provides period-end ownership patterns for a company. Set holders=true when you need the holder-level breakdown available in the source disclosure.
Coverage
| Records | Sources | Updated |
|---|---|---|
| 42K+ ownership snapshots | Exchange shareholding disclosures | Updated as new periods are filed |
Parameters
| Parameter | Type | Description |
|---|---|---|
tickerrequired | string | Company ticker or accepted reference |
period_end | date | Exact reporting date |
holders | boolean | Include holder-level detail |
limit | integer | 1–100; default 20 |
Getting started
Issue a key
Sign in, choose a plan and create an API key from your workspace dashboard.
Send the request
Call /v1/shareholding with X-API-Key or an Authorization bearer token.
Read data and metadata
Use data for records and meta for timestamps, counts and request context.
Implementation notes
- →Ownership snapshots describe the reporting date, not an intraday cap table.
- →Holder-level availability depends on the structure of the source disclosure.
Marked provides market data, not financial advice. Verify material decisions against the authoritative source.