IR PDF 配信 - 検索 / 一覧 (プレビュー)
統合報告書・サステナビリティレポート・中期経営計画書・決算説明資料など、各社 IR ページに掲載されている PDF 原本へのアクセスを提供する。EDINET 由来の有報 / 四半期報告書とは別系統 (各社 IR サイトからクロール → GCS キャッシュ)。
重要: プレビュー機能。プレビューが有効な環境でのみ動作。本番公開前は 404。
各 doc は配信 VIEW で is_active = TRUE AND delivery_status = 'available' + opt-out 企業除外を強制。 レスポンスは PDF 本体を含まない (pdf_url は別 EP /v1/ir/documents/{doc_id}/pdf-url で発行)。
過去分の提供範囲は 利用規約第12条 に基づく。
Request
- Base URL: https://edinetdb.jp/v1
- URL: https://edinetdb.jp/v1/ir/documents
- Auth: API key in header X-API-Key
Query parameters
EDINET code (繰り返し指定可)
doc_type slug (integrated / sustainability / midterm / decks / fact_book / annual_report / 等)。 2026-08 追加: internal_control (内部統制報告書。金商法第24条の4の4に基づく法定書類で、 従来 governance に含まれていたものを分離。訂正報告書 (同 4の5) も含む)。 2026-06 以降は適時開示の細分類 (計16種) も指定可能: disclosure_ma_reorg (M&A・組織再編) / disclosure_forecast_revision (業績予想修正) / disclosure_treasury_stock (自己株式) / disclosure_equity_capital (増資・社債) / disclosure_stock_split (株式分割・併合) / disclosure_shareholder_related (主要株主・株主提案) / disclosure_special_pl (特別損益) / disclosure_product_pr (製品・イベントPR) / disclosure_personnel_org (人事・組織異動) / disclosure_financial_other (その他財務関連開示) / disclosure_governance (適時開示: ガバナンス関連) / disclosure_other (その他の適時開示) / disclosure_correction (適時開示: 訂正) / disclosure_monthly_flash (月次売上速報) / disclosure_statutory (適時開示: 法定・臨報関連) / disclosure_dividend (適時開示: 配当関連)。 この細分類は自動分類(規則ベースと言語モデル) による参考・検索補助用途であり、投資判断のための 精密なイベント種別分類ではありません。 全 slug の一覧は GET /v1/ir/document-types を参照。
会計年度 (完全一致)。fiscal_year_is_null=true との同時指定は 400。If omitted, results are not filtered by fiscal year; all years are eligible, ordered by discovered_at (newest first) with cursor pagination. Zero matches return 200 with an empty data array (never 404).
true の場合、fiscal_year が NULL のドキュメントのみ返す。fiscal_year との同時指定は 400。 fiscal_year は配信元 IR ページの period_hint からの単純抽出のため、doc_type ごとに一定割合で NULL になる (統合報告書 ~30% / サステナレポート ~36% / 中期経営計画 ~54% / 決算説明資料 ~20%)。
fiscal_year が指定された場合、NULL のドキュメントも合わせて返す。 fiscal_year 未指定の場合は 400。
published_at >= YYYY-MM-DD
published_at <= YYYY-MM-DD
古い版と判定した資料を除く (判定は種類ごと。適時開示など年に何本も出る種類は絞らない。同じ会社・種類・年度・言語でも複数件返ることがあり、最新版 1 件への集約は保証しない)。false で絞らずに全件
企業の業種 (companies.industry 完全一致)。
タイトル キーワード部分一致 (大小文字区別なし)。
前回レスポンスの meta.next_cursor を渡してページネーション
Response
検索結果。meta.next_cursor が NULL でなければ次ページあり
Changes
No recorded changes to this operation across all 1 revision of this API.