提出書類と開示
提出書類の一覧と、有価証券報告書に記載された従業員、配当、温室効果ガス排出量の情報を扱います。
提出書類
sec_filings
Ticker.sec_filings -> list[dict]
Ticker.get_sec_filings() -> list[dict]直近 100 件の提出書類を新しい順に、yfinance のキー名で返します。絞り込みとページ送りには
get_filings を用います。
戻り値 — list[dict]
| キー | 型 | 説明 |
|---|---|---|
date | datetime.date | 提出日 |
epochDate | int | 提出日。UNIX 秒 |
type | str | 書類の種類（自己株券買付状況報告書 など） |
title | str | 書類の表題 |
documentId | str | EDINET の書類管理番号（S100Z1LW など） |
docTypeCode | str | EDINET の書類種別コード（"220" など） |
edgarUrl | None | yfinance との互換性を保つために設けたキーで、常に None |
get_filings
Ticker.filings -> pandas.DataFrame
Ticker.get_filings(types=None, year=None, limit=100, offset=0) -> pandas.DataFrameその会社について提出された書類を新しい順に返します。limit と offset で取得する範囲を
指定できます。総件数は .attrs["total"] で確認できます。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
types | list[str] | None | 書類種別コードのリスト（["120", "130"] で有価証券報告書とその訂正）。省略時はすべて |
year | int | None | 会計年度。省略時はすべての年度 |
limit | int | 100 | 返す行数。最大 1000 |
offset | int | 0 | 読み飛ばす行数 |
戻り値 — pandas.DataFrame
| 列 | 型 | 説明 |
|---|---|---|
Filing Date | datetime64 | 提出日 |
Type、Title | str | 書類の種類と表題 |
Period Start、Period End | datetime64 | 対象期間。書類に記載がある場合 |
Fiscal Year、Quarter | int, str | 会計年度と四半期 |
Is Correction | bool | 訂正報告書かどうか |
Parent Document ID | str | 訂正の対象となる書類 |
Accounting Standard | str | 日本基準・IFRS・米国基準 |
Doc Type Code、Document ID | str | EDINET のコード |
よく使う書類種別コードは次のとおりです。
| コード | 書類 |
|---|---|
120 / 130 | 有価証券報告書 / 訂正有価証券報告書 |
140 / 150 | 四半期報告書 / 訂正四半期報告書 |
160 / 170 | 半期報告書 / 訂正半期報告書 |
180 / 190 | 臨時報告書 / 訂正臨時報告書 |
220 | 自己株券買付状況報告書 |
235 | 内部統制報告書 |
350 / 360 | 大量保有報告書・変更報告書 / 訂正報告書（大量保有） |
get_report_filing_dates
Ticker.report_filing_dates -> pandas.DataFrame
Ticker.get_report_filing_dates(limit=12, offset=0) -> pandas.DataFrame有価証券報告書・半期報告書・四半期報告書の提出日を新しい順に返します。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
limit | int | 12 | 返す行数 |
offset | int | 0 | 読み飛ばす行数 |
戻り値 — pandas.DataFrame。インデックスは Filing Date です。
| 列 | 型 | 説明 |
|---|---|---|
Period Start、Period End | datetime64 | EDINET の書類一覧に記載された期間 |
Report Type | str | annual・quarterly・semiannual |
Amended | bool | 訂正報告書があるかどうか |
Fiscal Year | int | 会計年度 |
Document ID | str | EDINET の書類管理番号 |
これは yfinance の
earnings_dates（決算発表日）に当たるものではありません。EDINET の報告書は 決算発表の 2〜3 か月後に提出されます。半期報告書では
Period Start・Period Endが事業年度の期間であり、書類の表題と 一致します。半期の期間ではありません。四半期報告書では四半期の期間となります。
FilingCalendar
jfinance.FilingCalendar(start=None, end=None, session=None)日付を指定して、全社の提出書類を横断して取得します。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
start | str, datetime.date | None | 開始日（"2026-06-25" など） |
end | str, datetime.date | None | 終了日。省略時は start と同じ日 |
session | requests.Session | None | 再利用するセッション |
jf.FilingCalendar("2026-06-25").get_filings(types=["120"])FilingCalendar.get_filings
FilingCalendar.filings -> pandas.DataFrame
FilingCalendar.get_filings(types=None, limit=100, offset=0) -> pandas.DataFrame引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
types | list[str] | None | 書類種別コードのリスト |
limit | int | 100 | 返す行数。最大 1000 |
offset | int | 0 | 読み飛ばす行数 |
総件数は .attrs["total"] で確認できます。
有価証券報告書に基づく情報
get_employees
Ticker.employees -> pandas.DataFrame
Ticker.get_employees(by_segment=False) -> pandas.DataFrame有価証券報告書の「従業員の状況」を年度ごとに新しい順に返します。訂正報告書を反映します。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
by_segment | bool | False | 会社全体ではなくセグメント別の人数を返す |
戻り値 — pandas.DataFrame
by_segment=False のとき：
| 列 | 型 | 説明 |
|---|---|---|
Fiscal Year、Period End | int, datetime64 | 会計年度と期末日 |
Consolidated Employees、Consolidated Temporary Workers | float | 連結の従業員数と平均臨時雇用者数 |
Employees、Temporary Workers | float | 提出会社の従業員数と平均臨時雇用者数 |
Average Age Years、Average Age Months | float | 平均年齢 |
Average Length Of Service Years、Average Length Of Service Months | float | 平均勤続年数 |
Average Annual Salary | float | 平均年間給与（円） |
Document ID | str | EDINET の書類管理番号 |
by_segment=True のときは Fiscal Year、Segment、Label、Consolidated、Employees、
Temporary Workers を返します。
get_dividend_resolutions
Ticker.dividend_resolutions -> pandas.DataFrame
Ticker.get_dividend_resolutions() -> pandas.DataFrame有価証券報告書の「剰余金の配当」を、決議ごとに新しい順に返します。普通株式の配当に限ります。 XBRL に含まれるのは 2019 年度ごろの有価証券報告書からです。
戻り値 — pandas.DataFrame
| 列 | 型 | 説明 |
|---|---|---|
Resolution Date | datetime64 | 決議年月日 |
Resolution | str | 決議機関。書類の原文 |
Dividend Per Share | float | 1 株当たり配当額（円） |
Total Amount | float | 配当金の総額（円） |
Record Date | datetime64 | 基準日。記載がある場合 |
Fiscal Year | int | 会計年度 |
Document ID | str | EDINET の書類管理番号 |
これは会社が配当を決議した記録です。配当落ち日をインデックスとする yfinance の
dividendsとは異なります。
get_emissions
Ticker.emissions -> pandas.DataFrame
Ticker.get_emissions(as_dict=False) -> pandas.DataFrame | dict有価証券報告書のサステナビリティに関する記載から、温室効果ガス排出量（tCO2e）を返します。 XBRL に含まれるのは 2024 年度の有価証券報告書からです。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
as_dict | bool | False | DataFrame ではなく dict で返す |
戻り値 — pandas.DataFrame。行は Scope1・Scope2・Scope1And2・Scope3・
Scope1And2And3、列は期末日（新しい順）です。同じ期に複数の書類があるときは最新の値を採用します。
集計範囲は連結を優先し、なければ範囲の記載がない値を採用します。採用した集計範囲は
.attrs["basis"] で確認できます。
これは開示された排出量の数値であり、第三者が評価する ESG スコアを返す yfinance の
sustainabilityに当たるものではありません。