GET /companies/{companyId}/ownership

GET /api/signal-foundry/companies/{companyId}/ownership は、EDINET の根拠を持つ 大株主情報と、開示会社同士で相互確認できた保有関係を返します。

契約サマリー

リクエスト

まず Company Search で company_id を解決します。

curl -s \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  "https://signal-foundry.app/api/signal-foundry/companies/jpx_7203/ownership"

companyId には canonical company_id を推奨します。社名や証券コードしかない場合は、 先に sf search <query> --json または Company Search API を使います。

レスポンス

見る key:

• company_id
• facts.major_shareholders.periods[]
• facts.major_shareholders.periods[].shareholders[]
• facts.major_shareholders.changes[]
• facts.ownership_relations
• gaps[]
• usage

{
  "ok": true,
  "object": "company_ownership",
  "status": "completed",
  "company_id": "jpx_7203",
  "facts": {
    "major_shareholders": {
      "periods": [
        {
          "as_of_date": "<YYYY-MM-DD>",
          "filing_id": "<filing_id>",
          "share_unit": "<share_unit>",
          "evidence": {},
          "shareholders": [
            {
              "rank": 1,
              "shareholder_name": "<EDINET開示原文>",
              "shares": 0,
              "ownership_percent": 0,
              "source_locator": "<source_locator>"
            }
          ]
        }
      ],
      "changes": []
    },
    "ownership_relations": []
  },
  "gaps": []
}

periods は新しい対象期から最大 2 期です。changes はその 2 期を比較し、 entered、left、holding_changed を返します。株主名の正規化 key は比較だけに使い、 表示する shareholder_name は開示原文です。

ownership_relations は、最新の受理済み EDINET 開示で開示会社同士の相互確認が 取れた関係だけを返します。大株主表に名前があるだけでは、会社間関係として断定しません。

復旧方法

次に読む

• 会社の基本情報: Company Profile API
• EDINET filing を確認する: Company Filings API
• API 全体の auth と usage: API 概要