# Major Shareholders (EDINET)(/edinet/major-shareholders)

`GET`    /v2/edinet/major-shareholders

## Overview

Retrieves the major shareholders disclosed in the Annual Securities Report.

## Attention

> **Info**
>
> - Available from June 1, 2016 onward. Target document is the Annual Securities Report Form No.3.
> - Available on the Standard plan or higher (Free / Light plans cannot use this API). Historical range: Standard up to 10 years, Premium up to 20 years.
> - Major shareholders data typically contains the top 10 entries, but may include 11 or more when the report lists tied ranks, or only one when the issuer has a single 100%-owning parent.
> - Major shareholders data is available via API only. File download (CSV / Bulk) is not supported.

## Retrieve the major shareholders status

`GET` `https://api.jquants.com/v2/edinet/major-shareholders`

`edinet_code` / `code` / `date` are all optional.\
The parameter combinations and response are as follows.

- edinet\_code/code: –, date: – → All reports submitted today

- edinet\_code/code: ✓, date: – → Reports for the specified EDINET code / issue code (within the plan's historical range)

- edinet\_code/code: –, date: ✓ → All reports submitted on the specified date

- edinet\_code/code: ✓, date: ✓ → The report for the specified EDINET code / issue code submitted on the specified date

※ Specifying both `edinet_code` and `code` at the same time returns an error (400).\
※ If no matching data exists, an empty array (`"data": []`) is returned.

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key     |

### Query Parameters

| Parameter       | Type   | Required | Description                                                                              |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| edinet\_code    | string | Optional | EDINET code (e.g. E03814)                                                                |
| code            | string | Optional | Issue code (e.g. 86970 or 8697)                                                          |
| date            | string | Optional | Submission date (e.g. 20250620 or 2025-06-20)                                            |
| pagination\_key | string | Optional | Pagination key string Specify the value returned by the previous call's pagination\_key. |

### Sample request code

/v2/edinet/major-shareholders

**cURL**

```bash
curl -G https://api.jquants.com/v2/edinet/major-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})

await client.get('/v2/edinet/major-shareholders', {
params: {
  edinet_code: '{{edinet_code}}',
},
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
  "https://api.jquants.com/v2/edinet/major-shareholders",
  params={"edinet_code": "{{edinet_code}}"},
  headers=headers,
)
print(resp.json())
```

### Responses

### Response fields

#### Document metadata (one object per filing)

| Parameter   | Type   | Required | Description                                                         |
| ----------- | ------ | -------- | ------------------------------------------------------------------- |
| DocId       | string | Required | EDINET document management number (`S` + 7 alphanumeric characters) |
| Code        | string | Required | Issue code of the filer (5 digits)                                  |
| EdinetCode  | string | Required | EDINET code of the filer                                            |
| FilerName   | string | Required | Filer name (Japanese)                                               |
| FilerNameEn | string | Required | Filer name (English)                                                |
| DocTypeCode | string | Required | Document type code (`120` = Annual Securities Report)               |
| SubDate     | string | Required | Submission date (YYYY-MM-DD)                                        |
| SubTime     | string | Required | Submission time (HH:MM:SS)                                          |
| PerSt       | string | Required | Start date of the target fiscal year (YYYY-MM-DD)                   |
| PerEn       | string | Required | End date of the target fiscal year (YYYY-MM-DD)                     |
| Hldrs       | array  | Required | Array of shareholder records, sorted by Rank ascending              |

#### Hldrs array element

| Parameter | Type    | Required | Description                                                                                      |
| --------- | ------- | -------- | ------------------------------------------------------------------------------------------------ |
| Rank      | integer | Required | Rank (1–10; 11+ for ties)                                                                        |
| HldrName  | string  | Required | Name of the shareholder                                                                          |
| HldrAddr  | string  | Required | Address of the shareholder                                                                       |
| ShsHeld   | number  | Required | Number of shares held                                                                            |
| ShsRatio  | number  | Required | Ratio of shares held to issued shares (excluding treasury). Decimal expression (0.1881 = 18.81%) |

### Response sample

```bash {{ title: "200:OK" }}
{
    "data": [
        {
            "DocId": "S100YA84",
            "Code": "86970",
            "EdinetCode": "E03814",
            "FilerName": "株式会社日本取引所グループ",
            "FilerNameEn": "Japan Exchange Group, Inc.",
            "DocTypeCode": "120",
            "SubDate": "2026-06-11",
            "SubTime": "15:00:00",
            "PerSt": "2025-04-01",
            "PerEn": "2026-03-31",
            "Hldrs": [
                {
                    "Rank": 1,
                    "HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
                    "HldrAddr": "東京都港区赤坂１丁目８番１号　赤坂インターシティＡＩＲ",
                    "ShsHeld": 175830000,
                    "ShsRatio": 0.1704
                },
                {
                    "Rank": 2,
                    "HldrName": "株式会社日本カストディ銀行（信託口）",
                    "HldrAddr": "東京都中央区晴海１丁目８－１２",
                    "ShsHeld": 56970000,
                    "ShsRatio": 0.0552
                },
                {
                    "Rank": 3,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　５０５００１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 26685000,
                    "ShsRatio": 0.0259
                },
                {
                    "Rank": 4,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　　５０５３０１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 17838000,
                    "ShsRatio": 0.0173
                },
                {
                    "Rank": 5,
                    "HldrName": "ＪＰモルガン証券株式会社",
                    "HldrAddr": "東京都千代田区丸の内２丁目７－３　東京ビルディング",
                    "ShsHeld": 15316000,
                    "ShsRatio": 0.0148
                },
                {
                    "Rank": 6,
                    "HldrName": "ＪＰ　ＭＯＲＧＡＮ　ＣＨＡＳＥ　ＢＡＮＫ　３８５７８１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "２５　ＢＡＮＫ　ＳＴＲＥＥＴ，　ＣＡＮＡＲＹ　ＷＨＡＲＦ，　ＬＯＮＤＯＮ，　Ｅ１４　５ＪＰ，　　ＵＮＩＴＥＤ　ＫＩＮＧＤＯＭ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 15139000,
                    "ShsRatio": 0.0147
                },
                {
                    "Rank": 7,
                    "HldrName": "株式会社三菱ＵＦＪ銀行",
                    "HldrAddr": "東京都千代田区丸の内１丁目４番５号",
                    "ShsHeld": 15114000,
                    "ShsRatio": 0.0146
                },
                {
                    "Rank": 8,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　５０５１０３（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 14996000,
                    "ShsRatio": 0.0145
                },
                {
                    "Rank": 9,
                    "HldrName": "ＨＳＢＣ　ＨＯＮＧ　ＫＯＮＧ－ＴＲＥＡＳＵＲＹ　ＳＥＲＶＩＣＥＳ　Ａ／Ｃ　ＡＳＩＡＮ　ＥＱＵＩＴＩＥＳ　ＤＥＲＩＶＡＴＩＶＥＳ（常任代理人　香港上海銀行東京支店）",
                    "HldrAddr": "１　ＱＵＥＥＮ’Ｓ　ＲＯＡＤ　ＣＥＮＴＲＡＬ，ＨＯＮＧ　ＫＯＮＧ（東京都中央区日本橋３丁目１１－１）",
                    "ShsHeld": 14484000,
                    "ShsRatio": 0.014
                },
                {
                    "Rank": 10,
                    "HldrName": "Ｊ．Ｐ．　ＭＯＲＧＡＮ　ＢＡＮＫ　ＬＵＸＥＭＢＯＵＲＧ　Ｓ．Ａ．　３８４５１３（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＥＵＲＯＰＥＡＮ　ＢＡＮＫ　ＡＮＤ　ＢＵＳＩＮＥＳＳ　ＣＥＮＴＥＲ　６，　ＲＯＵＴＥ　ＤＥ　　ＴＲＥＶＥＳ，　Ｌ－２６３３　ＳＥＮＮＩＮＧＥＲＢＥＲＧ，　ＬＵＸＥＭＢＯＵＲＧ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 14035000,
                    "ShsRatio": 0.0136
                }
            ]
        }
    ],
    "pagination_key": "value1.value2."
}
```