すべてのAPI

企業開示書類APIで開示書類を取得

企業の開示書類を一覧し、開示書類のレコードを取得し、企業をまたいだ最新の開示書類を読み取れます。規制当局の公式の写しへのリンクも提供されます。

確認中97.81% uptime, last 30日295 ms 標準応答

最初のリクエスト

企業の年次開示書類を一覧表示する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

エンドポイント

GET企業の開示書類を一覧表示する/v1/companies/{company_id}/filings

企業の開示書類を新しい順に並べたもので、各書類の公式コピーへのリンク付きです。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

  • type任意

    annual などの開示書類のカテゴリ。

レスポンスフィールド

  • idフィールド

    開示書類の識別子

  • dateフィールド

    開示書類が提出された日付

  • typeフィールド

    開示書類の分類。例: 年次、四半期、イベント、保有

  • titleフィールド

    開示書類のタイトル

  • urlフィールド

    規制当局のサイトにある公式の開示書類へのリンク

  • company_idフィールド

    開示書類に関連する会社の識別子

  • formフィールド

    規制当局による様式の名称。例: 10-K や 13D

  • period_endフィールド

    開示書類が対象とする報告期間の終了日

  • filing_id (on stock earnings)フィールド

    過去の決算報告を扱う年次、半期、または四半期の報告書。開示書類ルートに渡すと、その記録を読めます。一致する開示書類がない場合や、日付に合う報告書がない場合は含まれません。


リファレンス全文 →
GET企業をまたいだ最新の開示書類を取得/v1/filings/latest

企業をまたいだ最新の開示書類。新しい報告書が出るたびに追跡するために使います。


リファレンス全文 →
GET開示書類のレコードを取得/v1/filings/{filing_id}

1件の開示書類の記録。様式、日付、公式コピーへのリンク付き。

パラメータ

  • filing_id必須

    usa:0000320193:0000320193-25-000079 のような開示書類ID。


リファレンス全文 →

ユースケース

スケジュールで更新する

小さなスクリプトで、新しい開示書類と数値を毎日取得します。

ガイドを読む →

新しい開示書類の通知を受け取る

開示書類の公開時にウェブフックを受け取り、検証します。

ガイドを読む →

企業データを数年分読み込む

長い履歴をページ送りで取得し、ジョブが止まっても再開します。

ガイドを読む →

利用上限を超えないようにする

レスポンスをキャッシュし、リクエストを失うことなく429エラーに対処します。

ガイドを読む →

企業についてエージェントに質問する

MCPを通じて、LLMエージェントに開示書類と財務情報の読み取りアクセスを与えます。

ガイドを読む →

カバレッジ

  • 米国開示書類と財務諸表。2009年からの履歴。
  • 日本3,800社超。年次と半期。
  • 韓国これまでのところ、上場企業の約半数。
  • 台湾約1,980社。2026年の半期報告書。
  • EUおよびEEA26か国の約3,200社。年次のみ。
  • 英国規制市場の約800社。年次のみ。

ソース

関連 API

NarwhalでSEC EDGAR APIを使う

SEC EDGAR による米国の開示書類と標準化された XBRL 財務データ、公開中

APIを見る →

EDINET APIの対応範囲が稼働中

日本の開示書類と財務諸表、公開中

APIを見る →

DART APIの対応範囲が稼働中

韓国の開示書類と財務諸表、公開中

APIを見る →

台湾の開示書類を扱うMOPS API

data.gov.tw の TWSE OpenAPI と TPEx オープンデータによる台湾の企業財務データ

APIを見る →

企業の年次報告を扱うESEF API

EU・EEA 26か国の企業の年次報告書

APIを見る →

Companies House APIで英国企業の財務報告

英国の規制市場の発行体による年次報告書

APIを見る →

よくある質問

外国民間発行体には、どの様式が対応しますか。

様式 20-F は年次、様式 6-K はイベントに分類されます。

ID を指定して開示書類を取得できますか。

GET /v1/filings/{filing_id} で、特定の開示書類のレコードを取得できます。

元の開示書類はどこで読めますか。

レコードの url をたどると、規制当局のサイトにある公式の写しに移動します。その文書が正本です。

決算報告から、その開示書類にはどうたどりますか。

株式ルートの過去の決算行には、その決算を扱う報告書を保有している場合に、開示書類IDが含まれます。これを開示書類ルートに渡してください。決算のEPSと開示書類の財務情報にあるEPSは、決算の数値が市場データの基準に基づくため、異なることがあります。

企業の開示書類の一覧

企業の開示書類を、種類、様式、日付で読み取れます。

最新の開示書類

1つのエンドポイントで、企業をまたいだ最新の開示書類を取得できます。

公式リンク

各レコードには、ID、日付、種類、タイトル、公式の開示書類へのリンクが含まれます。