# Share Holding Pattern

This API retrieves the shareholding pattern for a given company, identified by its company code (`cocode`). It returns detailed information about the distribution of shares among different shareholder categories, including Domestic Institutional Investors & Mutual Funds (DIIMF), Foreign Institutional Investors (FII), insurance companies, mutual funds, promoters, and others, along with the total number of shares and record count for each period.

**Note:** `cocode` can be obtained from the Search Stock or Company Basic Detail API.

**Endpoint**

```
https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}
```

**Request Parameter**

<table><thead><tr><th width="181">Name</th><th width="126">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>cocode</td><td>Y</td><td>The unique company code identifier.</td></tr></tbody></table>

**Request**

{% tabs %}
{% tab title="curl" %}
{% code title="cURL" overflow="wrap" lineNumbers="true" %}

```javascript
curl -X 'GET' \
  'https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}' \
  -H 'accept: application/json'
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}
{% code title="Java-Unirest" fullWidth="false" %}

```java
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}")
  .header("Content-Type", "application/json")
  .asString();
```

{% endcode %}
{% endtab %}

{% tab title="Go" %}
{% code title="Go-Native" overflow="wrap" lineNumbers="true" fullWidth="true" %}

```go
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"strings"
)

func main() {
	url := "https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}"
	method := "GET"

	client := &http.Client{}
	req, err := http.NewRequest(method, url, nil)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")

	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := ioutil.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript" %}
{% code title="JavaScript-jQuery" overflow="wrap" lineNumbers="true" %}

```javascript
var settings = {
  "url": "https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
```

{% endcode %}
{% endtab %}
{% endtabs %}

**Response**

```json
[
  {
    "DIIMFPer": 15.8476,
    "FIIPer": 21.2191,
    "insurancePer": 8.1716,
    "mutualFundsPer": 7.6474,
    "othersPer": 13.825500000000005,
    "promotersPer": 49.1078,
    "totalShares": 6766229014,
    "yearlyRecordCount": 202406
  },
  {
    "DIIMFPer": 15.5999,
    "FIIPer": 21.5285,
    "insurancePer": 8.2659,
    "mutualFundsPer": 7.3248,
    "othersPer": 13.762899999999993,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202403
  },
  {
    "DIIMFPer": 15.223400000000002,
    "FIIPer": 21.6136,
    "insurancePer": 8.3533,
    "mutualFundsPer": 6.8052,
    "othersPer": 14.054300000000008,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202312
  },
  {
    "DIIMFPer": 14.6889,
    "FIIPer": 22.0786,
    "insurancePer": 8.2178,
    "mutualFundsPer": 6.4056,
    "othersPer": 14.123800000000006,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202309
  }
]
```

**Response Parameter**

<table><thead><tr><th width="191">Parameters</th><th>Description</th></tr></thead><tbody><tr><td>DIIMFPer</td><td>Percentage of shares held by Domestic Institutional Investors and Mutual Funds.</td></tr><tr><td>FIIPer</td><td>Percentage of shares held by Foreign Institutional Investors (FII).</td></tr><tr><td>insurancePer</td><td>Percentage of shares held by insurance companies.</td></tr><tr><td>mutualFundsPer</td><td>Percentage of shares held by mutual funds.</td></tr><tr><td>othersPer</td><td>Percentage of shares held by other shareholders.</td></tr><tr><td>promotersPer</td><td>Percentage of shares held by company promoters.</td></tr><tr><td>totalShares</td><td>Total number of shares outstanding.</td></tr><tr><td>yearlyRecordCount</td><td>Unique record identifier for the year, showing the time period of the data record.</td></tr></tbody></table>