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

GetSHP

GET
https://test.lisuns.com:4532/GetSHP
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetSHP returns Shareholding Pattern (SHP) information, which details the distribution of a company’s shares among its shareholders. This includes raw information on institutional investors, promoters, public shareholders, and any significant changes in ownership over a specific period. It helps investors assess control, voting power, and potential risks or opportunities related to the company’s ownership structure.
To use this function, you will need the name of the company which you can obtain from GetSHPItems function.

What is returned?#

Label, UnitId, Decimals, Value, Description, ContextName, From, To
For details, please see glossary

Sample Response#

Response TypeSample Response
JSONDownload JSON Response
XMLDownload XML Response
CSVDownload CSV Response
CSVContentThe file containing values in CSV format will be returned.

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/GetSHP?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&instrumentIdentifier=ARL&period=February 2025&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:08:38
Previous
GetShpItems
Next
GetSHPAdvanced
Built with