Shareholder Pattern

Retrieve detailed shareholder information and ownership structure for a specific company.

GET/3.0/company/shareholders

Description

This endpoint returns detailed shareholder information including major shareholders, institutional ownership, individual ownership, and shareholding patterns for a specific company. Provides insights into company ownership structure and concentration.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol/ticker code for the company	DGKC

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": {
        "created": "2025-10-03T06:15:36.168Z",
        "updated": "0001-01-01T00:00:00Z",
        "symbol": "DGKC",
        "periods": [
            {
                "year": "2025",
                "period_end": "2025-06-30",
                "year_end_diff": 0
            },
            {
                "year": "2024",
                "period_end": "2024-06-30",
                "year_end_diff": 0
            },
            {
                "year": "2023",
                "period_end": "2023-06-30",
                "year_end_diff": 0
            },
            {
                "year": "2022",
                "period_end": "2022-06-30",
                "year_end_diff": 0
            },
            {
                "year": "2021",
                "period_end": "2021-06-30",
                "year_end_diff": 0
            }
        ],
        "fields": [
            {
                "label": "Directors, Chief Executive Officer,   and their spouse and minor children",
                "values": [
                    0.0432,
                    0.0432,
                    0.0432,
                    0.0432,
                    0.0429
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Associated Companies, undertakings   and related parties.",
                "values": [
                    0.315,
                    0.315,
                    0.329,
                    0.3242,
                    0.3177
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "NIT and ICP",
                "values": [
                    0.0034,
                    0.003,
                    0.0046,
                    0.0047,
                    0.0042
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Banks Development Financial  Institutions Non Banking Financial Institutions.",
                "values": [
                    0.0415,
                    0.0749,
                    0.0913,
                    0.0972,
                    0.0503
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Insurance Companies",
                "values": [
                    0.0166,
                    0.0082,
                    0.0207,
                    0.0335,
                    0.0631
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Modarabas and Mutual Funds",
                "values": [
                    0.086,
                    0.0476,
                    0.0329,
                    0.03,
                    0.0656
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Shareholders holding 10%",
                "values": [
                    0.314,
                    0.314,
                    0.314,
                    0.314,
                    0.314
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "General Public:",
                "values": [],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Local",
                "values": [
                    0.1526,
                    0.1871,
                    0.221,
                    0.2186,
                    0.1947
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Foreign",
                "values": [
                    0.0097,
                    0.0225,
                    0.016,
                    0.0165,
                    0.0107
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Others",
                "values": [],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Joint Stock Companies",
                "values": [
                    0.064,
                    0.0482,
                    0.0375,
                    0.0422,
                    0.0426
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Charitable Trust, Foundations & Others",
                "values": [
                    0.0036,
                    0.03,
                    0.0043,
                    0.0032,
                    0
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Pension Funds, Provident Funds etc.",
                "values": [
                    0.0251,
                    0.0452,
                    0.0497,
                    0.0241,
                    0.0326
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Foreign Companies",
                "values": [
                    0.1145,
                    0.0512,
                    0.0399,
                    0.0377,
                    0.0507
                ],
                "is_heading": false,
                "key": null
            }
        ]
    }
}

Response Fields

Field	Type	Description
created	string	Timestamp when the record was created (ISO 8601 format)
updated	string	Timestamp when the record was last updated (ISO 8601 format)
symbol	string	Company stock symbol/ticker code
periods	array	Array of reporting periods View
fields	array	Array of shareholder information with values View

Periods Array Fields

Field	Type	Description
year	string	Reporting year
period_end	string	Period end date (YYYY-MM-DD)
year_end_diff	integer	Days difference from year end

Field Item Array Fields

Field	Type	Description
label	string	Shareholder category label or description
values	array	Array of shareholding values as percentages for each period
is_heading	boolean	Whether this field is a section heading
description	string	Detailed description of the shareholding category, optional
unit	string	Unit of measurement (%), optional
key	string	Machine-readable field identifier key, optional

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "no `symbol` provided"
}

Examples

Get Shareholder Pattern

curl -X GET "https://csapis.com/3.0/company/shareholders?symbol=DGKC" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Ownership Analysis: Understand company ownership structure
• Control Assessment: Evaluate management control and voting power
• Stakeholder Analysis: Identify major shareholders and their interests
• Institutional Interest: Track institutional investor participation
• Concentration Risk: Assess ownership concentration and diversification
• Corporate Governance: Evaluate governance implications of shareholding
• Due Diligence: Review ownership patterns for investment decisions
• Regulatory Compliance: Monitor compliance with shareholding regulations