1. Share Holding Patterns
  • Fundamental Data API - Introduction
  • Authentication, Request & Response
  • Code Samples & API Trial
  • List of APIs
  • Type of Corporate Data Available
  • Corporate Data APIs
    • Corporate Announcements
      • GetCorporateAnnouncementsCategories
      • GetCorporateAnnouncements
    • Corporate Announcement Attachment Downloader
      • GetCorporateAnnouncementAttachment
    • Corporate Actions
      • GetCorporateActionsCategories
      • GetCorporateActions
    • Financial Results
      • GetResultsCalendar
      • GetFinancialResultsItems
      • GetFinancialResults
      • GetFinRatioEOD
      • GetFinRatioQuarterly
      • GetFinRatioSnapshot
    • Sectoral Classification
      • GetSectoralClassification
      • GetSectors
      • GetMei
      • GetIndustries
      • GetBasicIndustries
    • Share Holding Patterns
      • GetShpItems
        GET
      • GetSHP
        GET
      • GetSHPAdvanced
        GET
    • Market Capitalization
      • GetScripMCap
      • GetExchangeMCap
    • Voting Results
      • GetVotingItems
      • GetVoting
    • Corporate Governance
      • GetCorporateGovernanceItems
      • GetCorporateGovernance
    • Annual Results (PDF)
      • GetAnnualReports
    • Company Information
      • GetCompanyData
    • Bulk / Block Deals
      • GetBulkDeals
      • GetBlockDeals
    • Delivery Volumes
      • GetDeliveryVolumes
    • Promoter's Pledge
      • GetConsolidatedPledge
  • Other Data APIs
    • Index Constituents
    • GetEODStats
      GET
    • GetBhavCopyCM
      GET
    • GetBhavCopyFO
      GET
    • GetFuturesAndOptions
      GET
    • GetIndexDetail
      GET
    • GetCircuitFilterDetails
      GET
    • GetStatisticsGroupAbCompanies
      GET
    • GetTop5GainersLosers
      GET
    • GetIndexHighlights
      GET
    • GetTotalTradeHighlights
      GET
    • GetScripGroupTradeHighlights
      GET
    • GetTurnoverDetailsOfTop15ScripsofAgroup
      GET
  • EOD Statistics
    • GetSeriesChange
    • GetBannedSecurities
    • ​GetDeliverable
    • GetVolatality
    • GetNewHL
    • GetCircuitBreakers
  • Helper APIs
    • GetServerInfo
    • GetLimitation
    • GetInstruments
  • Glossary
    • Glossary
  • Diagnostic API Responses
    • Diagnostic API Responses
  • Release Notes
    • 📢Release Notes
  1. Share Holding Patterns

GetSHPAdvanced

GET
https://test.lisuns.com:4532/GetSHPAdvanced
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetSHPAdvanced API provides detailed shareholding pattern data for a specified stock/instrument. By changing the type parameter, users can get specific breakdowns such as ListPromoters, SummaryPromoterPublicOthers, FII holdings, etc.
To use this function, you will need the name of the company which you can obtain from GetSHPItems function.

What is returned?#

Entity, Value, Period
For details, please see glossary

Sample Response#

JSON
XML
CSV
CsvContent
{
"Value": [
{
"Entity": "Promoter",
"Value": 58.22,
"Period": "February 2025"
},
{
"Entity": "Public",
"Value": 41.78,
"Period": "February 2025"
},
{
"Entity": "Others",
"Value": 0,
"Period": "February 2025"
}
]
}

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://test.lisuns.com:4532/GetSHPAdvanced?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&instrumentIdentifier=ARL&period=&type=SummaryPromoterPublicOthers&date=1740594600&format=Json'

Responses

🟢200OK
text/plain
Success
Body

Example
{
    "value": [
        {
            "label": "string",
            "unitId": "string",
            "decimals": 0,
            "value": "string",
            "description": "string",
            "contextName": "string",
            "from": "02-25-2025 18:00:00",
            "to": "02-25-2025 18:00:00"
        }
    ],
    "count": 0
}
Modified at 2025-10-22 16:11:15
Previous
GetSHP
Next
GetScripMCap
Built with