# Cross-Shareholdings (EDINET)(/edinet/cross-shareholdings)
`GET` /v2/edinet/cross-shareholdings
## Overview
Retrieves, per scope (the reporting company itself, the consolidated group company with the largest holdings, and the second-largest holdings) disclosed in Section 4 "Status of Shares" of the Annual Securities Report (Form No.3), the listed / non-listed share counts and their changes, the specified investment / deemed holding records, and footnote text.
## Attention
> **Info**
>
> - Available from March 31, 2020 onward. Target document is the Annual Securities Report.
> - 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.
> - Cross-shareholdings data is available via API only. File download (CSV / Bulk) is not supported.
> - The data provided by this API is refined using an LLM.
## Retrieve the cross-shareholdings status
`GET` `https://api.jquants.com/v2/edinet/cross-shareholdings`
`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. E02367) |
| code | string | Optional | Issue code (e.g. 79740 or 7974) |
| 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/cross-shareholdings
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/cross-shareholdings \
-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/cross-shareholdings', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/cross-shareholdings",
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) |
| Report | object | Required | Holdings block for the reporting company itself. |
| Largest | object | Required | Holdings block for the consolidated group company with the largest holdings. |
| SecondLargest | object | Required | Holdings block for the consolidated group company with the second-largest holdings. |
#### Holder block (shared by `Report` / `Largest` / `SecondLargest`)
| Parameter | Type | Required | Description |
| ------------------- | ------ | -------- | ----------------------------------------------------------------- |
| HldrName | string | Required | Name of this holder |
| HldrCode | string | Required | Issue code of this holder (5 digits) |
| HldrEdinetCode | string | Required | EDINET code of this holder |
| ListedIss | number | Required | Listed: number of issues |
| ListedBookVal | number | Required | Listed: total carrying amount (JPY) |
| ListedIncIss | number | Required | Listed: number of issues whose share count increased |
| ListedIncAcqCost | number | Required | Listed: total acquisition cost for the increased shares (JPY) |
| ListedDecIss | number | Required | Listed: number of issues whose share count decreased |
| ListedDecSaleAmt | number | Required | Listed: total sale amount for the decreased shares (JPY) |
| ListedIncRsn | string | Required | Listed: reason for the increase in shares |
| NonListedIss | number | Required | Non-listed: number of issues |
| NonListedBookVal | number | Required | Non-listed: total carrying amount (JPY) |
| NonListedIncIss | number | Required | Non-listed: number of issues whose share count increased |
| NonListedIncAcqCost | number | Required | Non-listed: total acquisition cost for the increased shares (JPY) |
| NonListedDecIss | number | Required | Non-listed: number of issues whose share count decreased |
| NonListedDecSaleAmt | number | Required | Non-listed: total sale amount for the decreased shares (JPY) |
| NonListedIncRsn | string | Required | Non-listed: reason for the increase in shares |
| Spec | array | Required | Array of specified investment holding records |
| Deem | array | Required | Array of deemed holding records |
| SpecFn | string | Required | Footnote for specified investment holdings |
| DeemFn | string | Required | Footnote for deemed holdings |
#### Issue record (element of `Spec[]` / `Deem[]`)
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| IsrName | string | Required | Name of the held entity |
| IsrCode | string | Required | Issue code of the held entity (5 digits, resolved by name from `IsrName`) |
| IsrEdinetCode | string | Required | EDINET code of the held entity (resolved by name from `IsrName`) |
| CurShs | number | Required | Number of shares in the current fiscal year |
| PriShs | number | Required | Number of shares in the prior fiscal year |
| CurBookVal | number | Required | Carrying amount in the current fiscal year (JPY) |
| PriBookVal | number | Required | Carrying amount in the prior fiscal year (JPY) |
| CurShsNotDisc | string | Required | Raw non-disclosure marker for the current-year share count (`*` / `＊` / `※` / `（注 N）`) |
| PriShsNotDisc | string | Required | Raw non-disclosure marker for the prior-year share count |
| CurBookValNotDisc | string | Required | Raw non-disclosure marker for the current-year carrying amount |
| PriBookValNotDisc | string | Required | Raw non-disclosure marker for the prior-year carrying amount |
| HoldRat | string | Required | Purpose / business alliance / quantitative effect / reason for increase (combined text) |
| IsrHolds | string | Required | Raw indicator of whether the issuer holds the reporting company's shares (e.g., `"有"` / `"無"` / `"無(注)３"`) |
| IsrHoldsCode | string | Required | Normalized 3-value form (`"1"` = holds, `"0"` = does not hold, `"2"` = undetermined) |
### 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",
"Report": {
"HldrName": "株式会社日本取引所グループ",
"HldrCode": "86970",
"HldrEdinetCode": "E03814",
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 6,
"NonListedBookVal": 1035000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [
{
"IsrName": "Sample Bank, Ltd.",
"IsrCode": "56780",
"IsrEdinetCode": "E05678",
"CurShs": 1200000,
"PriShs": 1200000,
"CurBookVal": 850000000,
"PriBookVal": 820000000,
"CurShsNotDisc": null,
"PriShsNotDisc": null,
"CurBookValNotDisc": null,
"PriBookValNotDisc": null,
"HoldRat": "To maintain and strengthen business relationships",
"IsrHolds": "有",
"IsrHoldsCode": "1"
}
],
"Deem": [
{
"IsrName": "Sample Electric Co., Ltd.",
"IsrCode": "90120",
"IsrEdinetCode": "E09012",
"CurShs": 500000,
"PriShs": null,
"CurBookVal": 350000000,
"PriBookVal": null,
"CurShsNotDisc": null,
"PriShsNotDisc": "（注3）",
"CurBookValNotDisc": null,
"PriBookValNotDisc": "（注3）",
"HoldRat": "Because the reporter holds voting-direction authority",
"IsrHolds": "無(注)３",
"IsrHoldsCode": "0"
}
],
"SpecFn": "Note: Specified investment shares are held to maintain and strengthen business relationships.
",
"DeemFn": "(Note 3) These shares are effectively held through a retirement benefit trust, and the reporter retains voting-direction authority under the trust agreement. Prior-period share counts and book values are not disclosed due to a change in the trust contract.
"
},
"Largest": null,
"SecondLargest": {
"HldrName": "株式会社東京証券取引所",
"HldrCode": null,
"HldrEdinetCode": null,
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 2,
"NonListedBookVal": 953000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [],
"Deem": [],
"SpecFn": null,
"DeemFn": null
}
}
],
"pagination_key": "value1.value2."
}
```