SEC 提出 API

企業別にSEC提出書類メタデータを一覧表示します。10-K、10-Q、8-K、Form 4、13F-HRを含みます。

エンドポイントとリクエスト

Narwhal APIキーで利用できます。

REST エンドポイント

GET /v1/companies/{company_id}/filings

リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/cmp_a1b2c3d4e5f678901234567890abcdef/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCPの使用 companies_list_filings 以下の対応する引数を使用します。REST と MCP は同じレスポンススキーマを返し、クォータ計算を共有します。

パラメータ

名前	必須	種別	意味
`company_id`	はい	パス · 不透明な Narwhal ID	企業検索で返される安定した企業識別情報。ティッカーと CIK は別名であり、永続的なルート識別子ではありません。
`forms`	いいえ	クエリ · カンマ区切りの SEC フォーム	大文字と小文字を区別するフォームトークン。修正版を除外しない限り、基本フォームは /A 修正版にも一致します。
`filed_from`	いいえ	クエリ · YYYY-MM-DD	提出日の下限（その日を含む）。
`filed_to`	いいえ	クエリ · YYYY-MM-DD	提出日の排他的な上限。filed_from より後でなければなりません。
`include_amendments`	いいえ	クエリ · ブール値	ベースフォームがリクエストされた場合は修正を含めます。デフォルトはtrueです。
`limit`	いいえ	クエリ · 整数、1～100	返す提出書類の最大数。デフォルトは50です。
`cursor`	いいえ	クエリ · 不透明な文字列	前ページの継続トークン。元のクエリとフィルターに束縛されています。

SEC フォームフィルター

正確な SEC フォームトークンを使用します。基本フォームには次を含められます： /A 次のような修正版： 10-K/A または 4/A、修正を除外しない限り。

フォーム	意味
`10-K`	年次企業報告書
`10-Q`	四半期企業報告書
`8-K`	重要な企業イベント
`20-F / 6-K`	外国民間発行体の報告書
`DEF 14A`	委任投票、取締役会、役員報酬
`Forms 3 / 4 / 5`	内部関係者の実質所有権と変動
`Schedule 13D / 13G`	大口の実質所有者
`13F-HR`	機関投資家運用者の保有状況
`S-1 / S-3 / 424B`	登録、募集、目論見書

このリストは一般的なフォームを説明するものです。固定の許可リストではありません。

レスポンス

{
  "company": {
    "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
    "name": "Apple Inc.",
    "cik": "0000320193"
  },
  "filings": [
    {
      "accession_number": "0000320193-24-000123",
      "form": "10-K",
      "filed_on": "2024-11-01",
      "accepted_at": "2024-11-01T10:01:36Z",
      "report_period": "2024-09-28",
      "is_amendment": false,
      "items": [],
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
      "primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

フィールド	種別	必須	意味
`company`	オブジェクト	はい	指定した発行体の安定した企業 ID、名称、CIK。
`filings`	配列	はい	提出書類のメタデータは受付時刻とアクセッション番号の順に並び、新しいものが先に表示されます。
`next_cursor`	文字列または null	はい	フィルター境界に結び付いた不透明な継続トークン、または完了時は null。
`as_of`	UTC タイムスタンプ	はい	ページ内のすべての提出書類で共有されるスナップショット時刻。

エラーとクォータ

400 invalid_query — クエリ、日付、フォーム、上限、カーソルが無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
404 company_not_found — 受け入れ済み公開データに企業 ID がありません。
429 rate_limit_exceeded または quota_exhausted — 共有の短時間枠または月間枠を使い切りました。
503 companies_unavailable — Companies が無効、権利が非アクティブ、または完全な受け入れ済み公開データを提供できません。

認証失敗と拒否されたスロットリング対象リクエストは月間クォータを消費しません。成功したRESTおよびMCP呼び出しは同じアカウント許容量を使用します。

初回リリースの対象範囲

最初のリリースに含まれるのはメタデータと正規 SEC 文書リンクだけです。提出書類本文、添付資料、XBRL ファクト、インサイダー取引、財務諸表、13F 保有情報は含まれません。

カバレッジは受け入れ済み発行体コホートに限定されます。利用可能なスナップショットについて、レスポンスのas_of時刻とカバレッジページを確認してください。