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

GetShpItems

GET
https://test.lisuns.com:4532/GetShpItems
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetSHPItems returns a list of companies along with the respective dates on which their Shareholding Pattern (SHP) has been reported. These details are then further used in next function (GetSHP) to get actual Share Holding Pattern.This function helps investors track ownership structures, including promoter holdings, institutional investors, and public shareholding over time.

What is returned?#

Date,Instrument
For details, please see glossary

Sample Response#

JSON
XML
CSV
CsvContent
{
"Value": [
{
"Date": 1740594600,
"Instrument": "ARL"
},
{
"Date": 1740594600,
"Instrument": "ARYAVAN"
},
{
"Date": 1740594600,
"Instrument": "ASHIS"
},
{
"Date": 1740594600,
"Instrument": "AVROIND"
},
{
"Date": 1740594600,
"Instrument": "AWL"
},
{
"Date": 1740594600,
"Instrument": "BNHOLDINGS"
},
{
"Date": 1740594600,
"Instrument": "DSKULKARNI"
},
{
"Date": 1740594600,
"Instrument": "RETAIL"
},
{
"Date": 1740594600,
"Instrument": "SUDTIND-B"
},
{
"Date": 1740594600,
"Instrument": "UGARSUGAR"
}
]
}

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/GetShpItems?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&from=1740594600&to=1740594600&instrumentIdentifiers=ASHIS+ARL&period=&dTFormat=String&format=Json'

Responses

🟢200OK
text/plain
Success
Body

Example
{
    "value": [
        {
            "date": "02-25-2025",
            "instrument": "string"
        }
    ],
    "count": 0
}
Modified at 2025-09-23 08:27:08
Previous
GetBasicIndustries
Next
GetSHP
Built with