Home / Learn / How to Get a Company's Shareholding Pattern via API
Guide

How to Get a Company's Shareholding Pattern via API

Updated 2026-10-18

Every listed Indian company discloses its shareholding pattern each quarter to the exchanges — how much is held by promoters, foreign institutional investors (FIIs), domestic institutions (DIIs), and the public. You can pull that breakdown as JSON.

The endpoint

Call GET /v1/stocks/{ticker}/shareholding with your API key. Each row is one quarterly disclosure, dated by as_on_date, with the percentage held by each category and the total share count.

Reading the categories

Promoter, FII, DII, mutual-fund, and individual holdings are all subsets of the total — tracking how promoter or FII holding changes quarter over quarter is a common signal for conviction or exit. The figures are as-disclosed to SEBI, so they reconcile to the company's own filing.

Related data

Pair this with mutual-fund holdings to see exactly which schemes make up the DII slice, or open a stock page to see the latest pattern rendered. Full field details are in the API reference.

More guides

How to Get NSE Quarterly Results via API

A developer's guide to fetching NSE & BSE quarterly and annual results programmatically — the endpoint, the fields, consolidation basis, and how to read the as-filed numbers correctly.

Read guide →

What Is the P/E Ratio (and How to Get It via API)

What the price-to-earnings ratio means, how it's calculated from price and EPS, the gotchas (negative earnings, consolidation basis), and how to fetch a stock's current P/E for any NSE/BSE company through an API.

Read guide →

How to Find Which Mutual Funds Hold a Stock (via API)

Find every mutual-fund scheme that holds a given NSE/BSE stock — quantity, market value, and % of AUM — built from AMFI and 40+ fund houses' own monthly portfolio disclosures, available as a REST API.

Read guide →

How to Get Indian Stock Prices via API (NSE & BSE EOD)

Fetch end-of-day OHLCV price history for any NSE or BSE stock via API — the endpoint, the fields, split/bonus adjustment, and how to build a clean price series.

Read guide →

ROE vs ROCE Explained (and How to Get Them via API)

What return on equity (ROE) and return on capital employed (ROCE) measure, how they differ, and how to fetch both for any Indian stock through a single API call.

Read guide →

How to Build a Stock Screener with an API

Build your own Indian stock screener programmatically — filter the NSE/BSE universe by market cap, P/E, ROE, ROCE and more using a single screener API endpoint.

Read guide →

How to Track Bulk Deals, Block Deals & Insider Trades via API

Follow the big trades — bulk deals, block deals, and SEBI insider/promoter (PIT) disclosures — for any Indian stock or market-wide, through a REST API.

Read guide →

NSE vs BSE: Which Ticker Should You Use with the API?

How ticker symbols work across NSE and BSE, why the same company can have two listings, and how to resolve names to the right ticker with the search API.

Read guide →

Try it with your own key

A free API key takes under a minute — no card required.

Get a free API key