ドキュメント
APIリファレンスサイト
すべてのドキュメントを閲覧

提出書類APIリファレンス

公式の登録機関による企業の財務データ、提出書類、5%以上の保有者をRESTとMCPで取得します。

8つの操作で、企業検索と企業情報、財務諸表、企業の開示書類一覧、個別の開示書類、最新の開示書類、5%以上の保有者、報告されたままの財務データを取得できます。報告書はSEC EDGAR、EDINET、DART、EU/EEAの年次報告書登録機関、および台湾から取得します。

RESTとMCPはBearerキー、スキーマ、クォータを共有し、各リクエストは1回の呼び出しとして数えられます。検索で企業を見つけ、返されたidをその企業へのリクエストに使用します。

操作一覧

操作REST パスMCPツール戻り値
企業検索GET /v1/companiesfilings_search_companies検索条件に一致する企業
企業情報の取得GET /v1/companies/{company_id}filings_get_company企業情報と証券
財務データの取得GET /v1/companies/{company_id}/financialsfilings_get_financials期間別の標準財務項目
企業の開示書類一覧GET /v1/companies/{company_id}/filingsfilings_list_company_filings企業の開示書類、新しい順
開示書類の取得GET /v1/filings/{filing_id}filings_get_filing開示書類の詳細と公式リンク
最新の開示書類GET /v1/filings/latestfilings_list_latest_filings全企業の最新の開示書類
保有者GET /v1/companies/{company_id}/holdersfilings_list_holders報告された5%以上の保有者
報告値GET /v1/filings/{filing_id}/financials/as-reportedfilings_get_as_reportedタグ付けされたままの財務データ

すべてのリクエストにBearerキーが必要です。RESTリクエストではAuthorization: Bearer $NARWHAL_API_KEYを使用します。 認証

企業IDと開示書類ID

検索で返された企業のidを使用します。台湾のIDは、接頭辞twn:の後に検索で返されたコードが続きます。

登録機関企業ID例
SEC EDGAR、米国usa:<CIK>usa:0000320193
EDINET、日本jpn:<EDINET code>jpn:E02144
DART、韓国kor:<corp code>kor:00126380
EUおよびEEAの年次報告書<iso3>:<LEI>prt:213800NI6JNPX5F44U15

開示書類IDは、企業IDと登録機関の受付番号をコロンで区切って組み合わせたものです。例はusa:0000320193:0000320193-25-000079です。

企業パスではusa:AAPLなどのティッカーエイリアスも使用でき、企業IDに解決されます。

企業情報の取得

企業情報、財務報告基準、社名の履歴、証券、関連企業を取得します。

  • as_of：その時点で有効なティッカーを選択するための日付です。
  • lang：デフォルトはenです。originalも指定できます。

企業情報には、取得可能な法的識別子、業種分類、状態の詳細が含まれます。fiscal_year_endはMMDD形式で、たとえば9月26日は0926です。standardはus_gaap、ifrs、j_gaap、jmis、k_gaapのいずれかを示します。namesには旧社名と日付が記録されます。securitiesには株式のクラス、種類、識別子、日付付きの上場情報が含まれます。relatedは重複上場企業、承継企業、前身企業を示します。この3つのフィールドは常にリストです。

企業情報
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000320193" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193",
  "name": "Apple Inc.",
  "country": "USA",
  "fiscal_year_end": "0926",
  "standard": "us_gaap",
  "industry": {
    "isic": "2620",
    "sector": "Manufacturing",
    "industry": "Manufacture of computer, electronic and optical products",
    "source_scheme": "us_sic",
    "source_code": "3571"
  },
  "names": [
    {
      "name": "APPLE INC",
      "from": "2007-01-10",
      "to": "2019-08-05"
    },
    {
      "name": "APPLE COMPUTER INC",
      "from": "1994-01-26",
      "to": "2007-01-04"
    },
    {
      "name": "APPLE COMPUTER INC/ FA",
      "from": "1997-07-28",
      "to": "1997-07-28"
    }
  ],
  "securities": [
    {
      "class": "common",
      "type": "common",
      "primary": true,
      "listings": [
        {
          "mic": "XNAS",
          "code": "AAPL",
          "from": "2026-10-20"
        }
      ]
    }
  ],
  "related": []
}

財務データの取得

企業の会計期間ごとの標準財務項目を新しい順に取得します。レスポンスでは、periodに応じてannual、semiannual、quarterlyのいずれかを行のキーとして使用します。

  • fields：カンマ区切りの標準項目名、またはallを指定します。デフォルトは一般的な15項目です。
  • statement：income、balance、cash_flow、per_share、shares、otherのいずれかに属する全項目を取得します。
  • period：デフォルトはannualです。semiannualまたはquarterlyも指定できますが、登録機関とプランの制限が適用されます。
  • fiscal_year：プランで取得可能な履歴範囲内の1会計年度です。
  • basis：consolidatedまたはstandaloneです。
  • version：デフォルトはlatestです。first_reportedにはProが必要です。
  • as_of：指定日に判明していた数値を取得します。Proが必要です。

標準項目は77項目で、損益計算書が29項目、貸借対照表が28項目、キャッシュフローが14項目、1株当たりが3項目、株式数が3項目です。fieldsで項目名を選択するか、fields=allで全項目を取得するか、statementで財務諸表の区分を選択します。デフォルトの15項目はrevenue、gross_profit、operating_income、net_income、cash、total_assets、total_debt、total_liabilities、total_equity、operating_cash_flow、capex、free_cash_flow、eps_diluted、dividend_per_share、shares_outstandingです。不明なフィールド名を指定すると、400 unknown_fieldが返されます。

選択した財務項目
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000320193/financials?fields=revenue,net_income,total_assets,eps_diluted" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193",
  "currency": "USD",
  "from_fy": 2023,
  "annual": [
    {
      "fy": 2025,
      "end": "2025-09-27",
      "derived": [],
      "revenue": "416161000000",
      "net_income": "112010000000",
      "total_assets": "359241000000",
      "eps_diluted": "7.46"
    },
    {
      "fy": 2024,
      "end": "2024-09-28",
      "derived": [],
      "revenue": "391035000000",
      "net_income": "93736000000",
      "total_assets": "364980000000",
      "eps_diluted": "6.08"
    },
    {
      "fy": 2023,
      "end": "2023-09-30",
      "derived": [],
      "revenue": "383285000000",
      "net_income": "96995000000",
      "total_assets": "352583000000",
      "eps_diluted": "6.13"
    }
  ]
}

金額は開示書類の通貨による10進数文字列で、通貨換算や桁の調整は行いません。欠損項目は省略され、報告値がゼロの場合は"0"のままです。各行には会計年度と期末日が含まれ、該当する場合は会計四半期または半期も示されます。derivedには、free_cash_flowなどNarwhalが計算した項目が列挙されます。常に公式の開示書類を正とします。

1株当たりの財務項目
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000320193/financials?statement=per_share" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193",
  "from_fy": 2023,
  "annual": [
    {
      "fy": 2025,
      "end": "2025-09-27",
      "currency": "USD",
      "derived": [],
      "eps_diluted": "7.46",
      "dividend_per_share": "1.02"
    },
    {
      "fy": 2024,
      "end": "2024-09-28",
      "currency": "USD",
      "derived": [],
      "eps_diluted": "6.08",
      "dividend_per_share": "0.98"
    },
    {
      "fy": 2023,
      "end": "2023-09-30",
      "currency": "USD",
      "derived": [],
      "eps_diluted": "6.13",
      "dividend_per_share": "0.94"
    }
  ]
}

日本では年次報告書と半期報告書が公表され、四半期報告書はありません。米国企業は年次報告書と四半期報告書を公表し、半期報告書はありません。台湾にも半期報告書はありません。EU/EEAの報告書は年次です。登録機関が公表していない期間を指定すると、使用すべき期間を示す詳細情報とともに404 period_not_publishedが返されます。

企業の開示書類一覧

種類、様式、提出日で絞り込み、企業の開示書類を取得します。

  • type：annual、semiannual、quarterly、event、ownership、insider、otherのいずれかです。
  • form：10-Kなどの正確な様式名です。最大20文字です。
  • filed_from：提出日の開始日です。
  • filed_to：提出日の終了日です。
  • include_amendments：訂正書類を含めるかどうかを指定します。デフォルトはfalseです。
  • cursor：同じフィルターで次のページを取得するためのカーソルです。
  • limit：結果件数は1から200です。デフォルトは50です。
  • lang：デフォルトはenです。originalも指定できます。

各行には開示書類、提出日、様式、種類、期末日が示され、登録機関が提供している場合はタイトルも含まれます。結果は新しい順です。次のページの取得にはnext_cursorを使用し、最終ページではnullになります。プランの制限により開始日が後ろに調整された場合は、調整後のfiled_fromが返されます。

企業の年次開示書類
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000320193/filings?type=annual&limit=2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193",
  "filed_from": "2023-10-27",
  "filings": [
    {
      "id": "usa:0000320193:0000320193-25-000079",
      "filed": "2025-10-31",
      "form": "10-K",
      "type": "annual",
      "period_end": "2025-09-27"
    },
    {
      "id": "usa:0000320193:0000320193-24-000123",
      "filed": "2024-11-01",
      "form": "10-K",
      "type": "annual",
      "period_end": "2024-09-28"
    }
  ],
  "next_cursor": "eyJpIjo0MTUwNjcsImtpbmQiOiJmaWxpbmdzIiwicSI6IjExYzkyYjY4YWJjZTMyM2YiLCJ0IjoiMjAyNC0xMS0wMVQxMDowMTozNiswMDowMCIsInYiOjF9.j2L56WYc-pkZ4UoI0z1vAN4htuG4nzEDOJUTtT_CZOY"
}

開示書類の取得

1件の開示書類のメタデータと登録機関の公式リンクを取得します。langのデフォルトはenで、originalも指定できます。

レスポンスは開示書類と企業を識別し、提出者が異なる場合はfiler_idを含みます。取得可能な場合は、様式、種類、タイトル、会計年度、期末日、UTCのfiled_atタイムスタンプが含まれます。fpはFY、H1、H2、またはQ1からQ4のいずれかを示します。urlは登録機関の公式開示書類ページへのリンクです。amendsは訂正対象の開示書類を示し、withdrawnは値がtrueの場合のみ含まれます。

提出書類の詳細
curl --request GET \
  --url "https://api.narwhalapi.com/v1/filings/usa:0000320193:0000320193-25-000079" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193:0000320193-25-000079",
  "company_id": "usa:0000320193",
  "form": "10-K",
  "type": "annual",
  "fy": 2025,
  "fp": "FY",
  "period_end": "2025-09-27",
  "filed_at": "2025-10-31T10:01:26Z",
  "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"
}

最新の開示書類

各行にcompany_idを含め、複数企業の最新の提出書類を取得します。

  • country：大文字のalpha-3国コードです。
  • type：annual、semiannual、quarterly、event、ownership、insider、otherのいずれかです。
  • limit：結果件数は1から200です。デフォルトは50です。
  • lang：デフォルトはenです。originalも指定できます。
最新の年次提出書類
curl --request GET \
  --url "https://api.narwhalapi.com/v1/filings/latest?country=USA&type=annual&limit=2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "filings": [
    {
      "id": "usa:0001888525:0001213900-26-112533",
      "filed": "2026-10-26",
      "form": "20-F",
      "type": "annual",
      "title": "ANNUAL REPORT",
      "company_id": "usa:0001888525"
    },
    {
      "id": "usa:0001901203:0001213900-26-112531",
      "filed": "2026-10-26",
      "form": "10-K/A",
      "type": "annual",
      "title": "AMENDMENT NO. 2 TO FORM 10-K",
      "company_id": "usa:0001901203"
    }
  ]
}

5%以上の保有者

米国、日本、韓国の保有状況に関する提出書類に記載された保有者を取得します。一覧には各保有者の最新の報告を使用し、保有を解消した保有者を除外します。

  • security：株式の種類です。最大40文字です。
  • lang：デフォルトはenです。originalも指定できます。
  • limit：取得件数は1から500件で、デフォルトは100件です。

各行には、取得可能な範囲で保有者、保有割合、株式数、事由発生日、提出日、提出書類ID、株式の種類を含めます。一覧はページ分割されません。プランの制限により開始日が繰り下げられた場合は、filed_fromをレスポンスに含めます。

報告された大口保有者
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000320193/holders?limit=2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "id": "usa:0000320193",
  "filed_from": "2023-10-27",
  "holders": [
    {
      "holder": "Vanguard Capital Management",
      "percent": "7.48",
      "shares": "1099168953",
      "event_date": "2026-03-31",
      "filed": "2026-04-30",
      "filing_id": "usa:0000320193:0002100119-26-000139",
      "security": {
        "class": "common"
      }
    }
  ]
}

報告原文の財務データ

1つの提出書類に含まれる財務データを、付与されたタグのまま概念別に取得します。この操作は、提出書類の検索範囲内であればすべてのプランで利用できます。

conceptsの各要素には、taxonomy、concept、label、unit、valuesリストが含まれます。各値には、存在する場合にstart、end、valueが含まれます。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/filings/usa:0000320193:0000320193-25-000079/financials/as-reported" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
{
  "concepts": [
    {
      "taxonomy": "us-gaap",
      "concept": "Revenues",
      "label": "Revenues",
      "unit": "USD",
      "values": [
        {
          "start": "2023-10-01",
          "end": "2024-09-28",
          "value": "391035000000"
        },
        {
          "start": "2022-09-25",
          "end": "2023-09-30",
          "value": "383285000000"
        }
      ]
    }
  ]
}

米国の提出書類のみに対応し、日本と韓国の提出書類では404 as_reported_unavailableを返します。1つの提出書類に数千件の財務データが含まれる場合があるため、レスポンスは数百キロバイトになることがあります。結果はページ分割されません。

プランの上限

すべての操作と標準項目をすべてのプランで利用できます。履歴の範囲と配信タイミングはプランによって決まります。

無料BasicPro
財務データの履歴直近3会計年度直近10会計年度全期間の履歴
対象期間年次年次、半期、四半期年次、半期、四半期
提出書類一覧と保有者直近3年間直近10年間全期間の履歴
配信翌日ライブライブ
初回報告値と指定日時点の数値いいえいいえはい

開始時点のみがプランの対象期間より前にあるリクエストは、プランの対象期間に切り詰められます。財務データではfrom_fy、提出書類と保有者ではfiled_fromにその開始時点を示します。提出書類と保有者の対象期間には暦年を使用します。Freeで配信されるのは、本日の00:00 UTCより前に提出された書類のみです。

Freeで四半期または半期の財務データをリクエストした場合、履歴の対象期間より前のfiscal_yearまたはfiled_toを指定した場合、Pro未満のプランでversion=first_reportedまたはas_ofを指定して財務データをリクエストした場合は、クォータを消費する前に403 plan_upgrade_requiredを返します。

レスポンスの規則

  • 数値は10進数の文字列で返します。
  • 値のないスカラーフィールドは省略し、nullでは返しません。
  • リストは常に含まれ、空の場合は[]を返します。
  • delistedやwithdrawnなどのフラグは、真の場合のみ含まれます。
  • 最終ページではnext_cursorがnullになります。
  • lang=originalを指定すると、取得可能な場合は登録機関が使用する言語で名称や表題を返します。デフォルトはenです。

エラー

  • 400 invalid_query クエリが無効です。
  • 400 unknown_field fieldsに標準の財務項目ではない名前が含まれています。
  • 400 invalid_cursor カーソルの形式が正しくないか、異なるフィルター条件に対して発行されたカーソルです。
  • 401 invalid_api_key APIキーが無効です。
  • 403 plan_upgrade_required リクエストされた履歴、対象期間、または財務データのバージョンは、プランの対象外です。
  • 404 company_not_found 企業が見つかりません。
  • 404 filing_not_found 提出書類が見つかりません。
  • 404 period_not_published 登録機関はリクエストされた対象期間のデータを公開していません。詳細には、使用すべき対象期間が示されます。
  • 404 as_reported_unavailable この提出書類では、報告原文の財務データを取得できません。
  • 429 rate_limit_exceeded リクエストのレート制限を超えました。
  • 429 quota_exhausted リクエストのクォータを使い切りました。
  • 503 database_unavailable データストアを利用できません。リクエストを再試行してください。

エラーは標準の問題詳細形式で返します。 エラーとクォータ

認証のドキュメントではBearerキー、エラーのドキュメントでは標準の問題詳細形式、MCPのドキュメントではツールへのアクセス方法を説明しています。 認証 · エラーとクォータ · MCP