すべてのドキュメントを閲覧

開示書類テキストとセグメントのAPIリファレンス

米国の開示書類のテキストを項目別に、セグメント、製品、地域別の数値

概要

開示書類のテキストは、米国企業が10-K、10-Q、20-F、8-Kに書いた本文を、Item 1Aのリスク要因やItem 7の経営陣による討議といった項目の見出しで区切って返します。セグメントは、企業がセグメント別、製品別、地域別に分けた数値を財務諸表に加えます。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。

ルートは4つです。2つは1つの開示書類の本文を返し、1つは開示書類IDで、もう1つは企業、フォーム、会計年度で指定します。1つは各フォームの項目を一覧にします。4つ目は財務ルートのsegments=trueで、ルート名も料金もそのままです。企業は開示書類APIのID、たとえばusa:0000320193で指定し、開示書類は企業ID、コロン、SECのアクセッション番号で指定します。

履歴は5年分です。本文がまだ読み込まれていない開示書類は404 sections_unavailableです。その期間自身の報告書がセグメント用にまだ読み込まれていない期間は、segments_unreadに一覧されます。

テキストのルートは米国、日本、韓国に対応します。米国の開示書類は10-K、10-Q、20-F、8-Kです。日本の開示書類はYUHO、HANKI、SHIHANKI、RINJI、韓国の開示書類は사업보고서、반기보고서、분기보고서です。企業の国とは別の国のフォームは400 invalid_queryです。それ以外の国の企業は404 not_coveredです。本文がまだ読み込まれていない日本または韓国の開示書類は404 sections_unavailableです。セグメントは米国企業のみが対象です。

ベースURL: https://api.narwhalapi.com。 以下の各ルートは、同じパラメータを持つ独立したMCPツールです。

各財務諸表の行は次にあります: 財務諸表API:開示書類リファレンス。

企業IDは次が返すものです: 開示書類 API 企業検索から返されます。

すべてのアカウントで利用できるもの

課金額すべてのアカウント
開示書類のテキスト、2ルート含まれる
項目一覧含まれる、無料
財務データのセグメント含まれる

参照: 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

  • 料金はCompanies料金で、1,000回の呼び出しにつき$10です。成功したテキストの応答は、項目、サイズ、形式を問わず1回の呼び出しです。企業を指定した8-Kは、項目を探すために最新の8-Kを最大10件読みますが、それでも1回の呼び出しです。中身のない応答は無料で、テキストのルートでは何も見つからない場合は404になり、これも無料です。項目一覧は無料です。エラーは課金されません。
  • segments=trueは、呼び出しも料金も増やしません。これを付けた財務データも、付けない場合と同じ1回の呼び出しです。財務の行がある応答は、segmentsに行があっても、空でも、省略しても、1回の呼び出しとして課金されます。
  • テキストは開示書類そのもので、項目の見出しで区切ったものです。書き換えも要約もしません。項目を区別できなかった開示書類は404 sections_unavailableで、部分的なテキストが返ることはありません。
  • 10-Qには、Part IにItem 1があり、Part IIにも別のItem 1があります。partを付けないと、item=1は両方を返します。
  • itemを付けない8-Kは、添付書類のテキストもexhibitsとして返します。添付書類のテキストが途中で切られている場合、truncatedはtrueです。
  • セグメントの行は、その期間自身の報告書に提出されたとおりの数値を示します。valueと、それが提出されたfiling_idです。後の開示書類が数値を変更した場合は、restatedにその後の数値と、その出典の開示書類が入ります。version=first_reportedは、提出時の数値だけを返します。
  • restated_onlyの行には、valueもfiling_idもありません。提出時の数値が保持されていないためです。その期間の報告書にそのメンバーがない場合(後の開示書類がその期間を別のメンバーに区切り直したため)か、報告書がまだ読み込まれていない場合です。後者ではrestatedは後の開示書類の数値で、修正再表示ですらないことがあります。
  • segments_unreadは、その期間自身の報告書がセグメント用にまだ読み込まれていない期間の終了日を、新しい順に並べます。提出時の数値がないのは、提出がなかったという意味ではありません。それらの期間にある行はrestated_onlyです。読み込まれた期間がなく、後の開示書類にも数値がない場合、segmentsは省略されます。
  • memberとlabelは、セグメント、製品、地域に対する企業自身の言葉で、企業をまたいで照合されることはありません。conceptは企業が使ったタグなので、measureが同じ2つの数値、たとえばセグメント間売上を含む売上と含まない売上も、別のままです。
  • percent_of_totalは、filing_idで示される開示書類にある同じ概念と期間の連結数値に対する、その数値の割合(パーセント)で、小数第2位までです。提出者が小計や連結のメンバーを加えるため、メンバーの合計が100になるとは限りません。その開示書類に、同じ概念と期間の連結数値がない場合は省略されます。
  • セグメントの数値はcurrencyの通貨単位そのままの数値です。資産やのれんなど、ある日付時点の数値にはstartがありません。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

開示書類の本文を項目別に取得

GET /v1/filings/{filing_id}/sections

開示書類1件の本文を、項目の見出しで区切って返します。すべての項目、またはitemで1つの項目です。米国の10-K、10-Q、20-F、8-K、または日本や韓国の報告書です。項目を区別できなかった開示書類は404 sections_unavailableで、部分的なテキストが返ることはありません。

MCP: ツール filings_get_sections。

パラメータ

パラメータ場所必須種別意味
filing_idパスはい文字列開示書類ID。企業ID、コロン、SECのアクセッション番号の順で、たとえばusa:0000320193:0000320193-26-000026です。開示書類APIで一覧できます。
itemクエリいいえ文字列番号で指定する1つの項目。たとえば1Aや7です。8-Kの項目は2.02のような形です。省略するとすべての項目が返ります。開示書類にない項目は404 item_not_foundです。
partクエリいいえ文字列部(IからIV)。10-Qには、Part IにItem 1があり、Part IIにも別のItem 1があります。partを付けないと、itemは両方を返します。

レスポンスフィールド

フィールド種別送信意味
id文字列常に開示書類ID。財務データでは企業ID。
form文字列常に開示書類のフォーム。例:10-K。
sectionsオブジェクトの配列常に開示書類の項目。開示書類での並び順です。
sections[].item文字列常に項目番号。例:1A。8-Kでは2.02など。
sections[].title文字列常に項目の見出し。例:Risk Factors。
sections[].text文字列常に項目のテキスト。提出されたままです。
sections[].part文字列任意項目が属する部。IからIVです。そのフォームに部がない場合は省略されます。
exhibitsオブジェクトの配列任意8-Kの添付書類ファイルをテキストにしたもの。itemを省略したときに返されます。
exhibits[].type文字列常に添付書類の種類。例:EX-99.1。
exhibits[].name文字列常に添付書類のファイル名。
exhibits[].text文字列常に添付書類のテキスト。
exhibits[].truncatedブール値任意テキストが途中で切られた場合はtrue。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/filings/usa:0000320193:0000320193-26-000026/sections?item=1A"
レスポンスの例
{
  "id": "usa:0000320193:0000320193-26-000026",
  "form": "10-K",
  "sections": [
    {
      "item": "1A",
      "title": "Risk Factors",
      "text": "The following summarizes factors that could have a material adverse effect on the Company’s business, reputation, results of operations, financial condition and…",
      "part": "I"
    }
  ]
}

企業の開示書類テキストをフォームと年で取得

GET /v1/companies/{company_id}/sections

開示書類ルートと同じテキストを、企業、フォーム、会計年度で探すので、開示書類IDは不要です。yearを付けないと、そのフォームの最新の開示書類です。itemを付けた8-Kでは、企業の直近10件の8-Kのうち、その項目がある最新のものです。

form=10-Qと一緒にquarterを使うと、四半期を選べます。ほかのフォームでは400 invalid_queryです。

MCP: ツール filings_get_company_sections。

パラメータ

パラメータ場所必須種別意味
company_idパスはい文字列企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。
formクエリはいone of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서フォームは、企業の国での呼び方で指定します。米国は10-K、10-Q、20-F、8-K、日本はYUHO、HANKI、SHIHANKI、RINJI、韓国は사업보고서、반기보고서、분기보고서です。それ以外の値は400 invalid_queryです。
yearクエリいいえ整数10-K、10-Q、20-Fでは会計年度、8-Kでは提出された年です。省略すると最新の開示書類です。
quarterクエリいいえ整数会計四半期。四半期報告書(10-Q、SHIHANKI、분기보고서)にのみ使います。
itemクエリいいえ文字列項目を1つ指定します。例:1A。8-Kでは、企業の直近10件の8-Kのうち、その項目がある最新のものが返ります(8-Kは1つの出来事を報告するため、最新のものにその項目がないことがよくあります)。itemを省略すると、最新の8-Kです。
partクエリいいえ文字列部。IからIVです。10-Qには、Part IにItem 1があり、Part IIにも別のItem 1があります。partを付けないと、itemは両方を返します。

レスポンスフィールド

フィールド種別送信意味
id文字列常に開示書類ID。財務データでは企業ID。
form文字列常に開示書類のフォーム。例:10-K。
sectionsオブジェクトの配列常に開示書類の項目。開示書類での並び順です。
sections[].item文字列常に項目番号。例:1A。8-Kでは2.02など。
sections[].title文字列常に項目の見出し。例:Risk Factors。
sections[].text文字列常に項目のテキスト。提出されたままです。
sections[].part文字列任意項目が属する部。IからIVです。そのフォームに部がない場合は省略されます。
exhibitsオブジェクトの配列任意8-Kの添付書類ファイルをテキストにしたもの。itemを省略したときに返されます。
exhibits[].type文字列常に添付書類の種類。例:EX-99.1。
exhibits[].name文字列常に添付書類のファイル名。
exhibits[].text文字列常に添付書類のテキスト。
exhibits[].truncatedブール値任意テキストが途中で切られた場合はtrue。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/sections?form=8-K"
レスポンスの例
{
  "id": "usa:0000320193:0001140361-26-042798",
  "form": "8-K",
  "sections": [
    {
      "item": "8.01",
      "title": "Other Events",
      "text": "Other Events.\nOn November 9, 2026, Apple Inc. (“Apple”) consummated the issuance and sale of $500,000,000 aggregate principal amount of its Floating Rate Notes…"
    },
    {
      "item": "9.01",
      "title": "Financial Statements and Exhibits",
      "text": "Financial Statements and Exhibits.\n(d) Exhibits.\nExhibit\nNumber\nExhibit Description\n1.1 Underwriting Agreement, dated November 5, 2026, among Apple Inc. and Gol…"
    }
  ],
  "exhibits": [
    {
      "type": "EX-1.1",
      "name": "ef20085077_ex1-1.htm",
      "text": "EX-1.1 2 ef20085077_ex1-1.htm EXHIBIT 1.1\nExhibit 1.1\nApple Inc.\n$500,000,000 Floating Rate Notes due 2028\n$750,000,000 Floating Rate Notes due 2029\n$1,000,000,…"
    },
    {
      "type": "EX-4.1",
      "name": "ef20085077_ex4-1.htm",
      "text": "EX-4.1 3 ef20085077_ex4-1.htm EXHIBIT 4.1\nExhibit 4.1\nAPPLE INC.\nOfficer’s Certificate\nPursuant to Sections 102 and 301 of the Indenture, dated as of November 1…"
    }
  ]
}

各フォームの項目を一覧する

GET /v1/filings/sections/items

テキストのルートが返せる項目を、フォームごとに、項目、部、タイトルで示します。無料です。このルートは課金されません。

先に項目を取得し、そのうちの1つをテキストのルートのitemとして渡します。

MCP: ツール filings_list_section_items。

パラメータ

パラメータ場所必須種別意味
formクエリいいえone of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서1つのフォームの項目。上の3つの一覧のいずれかから選びます。省略すると、米国の4つのフォームの項目です。

レスポンスフィールド

フィールド種別送信意味
itemsオブジェクトの配列常に項目。フォームごと。
items[].formone of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서常に項目が属するフォーム。
items[].item文字列常にitemが受け取る形の項目番号。
items[].title文字列常に項目の見出し。
items[].part文字列任意項目が属する部。そのフォームに部がない場合は省略されます。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/filings/sections/items?form=10-K"
レスポンスの例
{
  "items": [
    {
      "form": "10-K",
      "item": "1",
      "title": "Business",
      "part": "I"
    },
    {
      "form": "10-K",
      "item": "1A",
      "title": "Risk Factors",
      "part": "I"
    },
    {
      "form": "10-K",
      "item": "1B",
      "title": "Unresolved Staff Comments",
      "part": "I"
    },
    {
      "form": "10-K",
      "item": "1C",
      "title": "Cybersecurity",
      "part": "I"
    }
  ]
}

財務諸表とあわせてセグメントを取得

GET /v1/companies/{company_id}/financials

segments=trueは、財務諸表の応答にsegmentsを加えます。企業がセグメント別、製品別、地域別に分けて示す売上、営業利益、資産、設備投資、減価償却、のれん、長期性資産です。これを付けない財務データと同じルート、同じ料金です。各財務諸表の行は開示書類APIのページにあります。

segments=trueがない場合、これは開示書類APIの財務ルートで、応答にsegmentsはありません。付けると、ある期間または後の開示書類が数値を示すときにsegmentsが送られます。最新の期間が先頭で、売上がほかの指標より先に並びます。

セグメントは応答に含まれる期間に従うため、period、fiscal_year、as_of、versionは同じように絞り込みます。

MCP: ツール filings_get_financials。

パラメータ

パラメータ場所必須種別意味
company_idパスはい文字列企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。
fieldsクエリいいえ文字列標準項目名をカンマで区切ったもの、またはall。省略すると、よく使う15項目です。
statementクエリいいえone of income, balance, cash_flow, per_share, shares, other1つの財務諸表のすべての項目:income、balance、cash_flow、per_share、shares、other。
periodクエリいいえone of annual, semiannual, quarterly既定はannualで、semiannualまたはquarterlyは登録機関が公表している範囲で使えます。米国企業には半期の報告がありません。
fiscal_yearクエリいいえ整数1会計年度。
basisクエリいいえone of consolidated, standaloneconsolidatedまたはstandalone。
versionクエリいいえone of latest, first_reported既定はlatestで、first_reportedも指定できます。
as_ofクエリいいえ日付この日に把握されていた数値(YYYY-MM-DD)。
segmentsクエリいいえブール値trueはsegmentsを加えます。応答の期間について、提出者がセグメント別、製品別、地域別に分けて示す売上、営業利益、資産、設備投資、減価償却、のれん、長期性資産です。ラベルは企業自身のもので、開示書類の言語のままで、各数値にcurrencyが付きます。数値は、その期間自身の報告書に提出されたとおり(value、filing_id)に示され、後の開示書類が変更した場合は、その開示書類とともにrestatedとして示されます。version=first_reportedは、提出時の数値だけを返します。セグメント用に報告書がまだ読み込まれていない期間はsegments_unreadに示され、その行は後の開示書類から来ます。内訳に対応していない国の企業は404 not_coveredです。

レスポンスフィールド

フィールド種別送信意味
id文字列常に開示書類ID。財務データでは企業ID。
currency文字列任意財務諸表の金額の通貨。
basisone of consolidated, standalone任意consolidatedまたはstandalone。
from_fy整数任意応答に含まれる最初の会計年度。履歴が切り詰められたときに送られます。そうでない場合は省略されます。
annualオブジェクトの配列任意年次の行。新しい順です。periodが求める場合、行のキーはsemiannualまたはquarterlyになります。行の項目は開示書類APIのページにあります。
semiannualオブジェクトの配列任意period=semiannualのときの半期の行。
quarterlyオブジェクトの配列任意period=quarterlyのときの四半期の行。
as_of日付任意数値の基準日。
segmentsオブジェクトの配列任意応答に含まれる期間の内訳。新しい期間が先頭です。読み込まれた期間がなく、後の開示書類にも数値がない場合は省略されます。
segments[].end日付常に期間の終了日、または数値の日付。
segments[].start日付任意期間の開始日。資産やのれんなど、ある日付時点の数値では省略されます。
segments[].measureone of revenue, operating_income, assets, capex, depreciation, goodwill, long_lived_assets常に測る対象:revenue、operating_income、assets、capex、depreciation、goodwill、long_lived_assets。
segments[].axisone of segment, product, geography常に企業が分ける軸:segment、product、geography。
segments[].member文字列常にセグメント、製品、地域に対する企業の名称。開示書類でのタグのままです。
segments[].label文字列任意メンバーに対する企業自身の表現。
segments[].concept文字列常に数値に企業が使ったタグ。
segments[].value文字列任意この期間の報告書(filing_id)に提出されたとおりの数値。restated_onlyのメンバーでは省略されます。
segments[].filing_id文字列任意valueが提出された開示書類。この期間の最初の報告書です。
segments[].currency文字列常に数値の通貨。
segments[].percent_of_total文字列任意filing_idの開示書類にある、同じ概念、期間、通貨の連結数値に対する値の割合(パーセント)。小数第2位まで、ゼロから遠い方向への四捨五入です("37.42")。開示書類自身の次元のない数値であり、メンバーの合計ではありません。提出者が小計や連結のメンバーを加え、一部は未配分費用控除前のセグメント利益に連結の概念のタグを付けるため、メンバーの合計が100になるとは限りません。値と合計の符号が逆のとき(黒字企業の赤字セグメント)は負になり、連結が赤字の企業の赤字セグメントは正になります。その開示書類に同じ概念と期間の連結数値がない場合(たとえば合計が別の概念でタグ付けされている場合)、合計がゼロの場合、または通貨が異なる場合は省略されます。
segments[].restatedオブジェクト任意後の開示書類が示す数値。提出時の数値を変更した場合に、その開示書類とともに示されます。restated_onlyの行では、保持されている唯一の数値で、修正再表示ではないこともあります。
segments[].restated.value文字列常に修正再表示後の数値。currencyの通貨単位そのままの数値です。
segments[].restated.filing_id文字列常に修正再表示後の数値の出典である、後の開示書類。
segments[].restated.percent_of_total文字列任意filing_idの開示書類にある、同じ概念、期間、通貨の連結数値に対する値の割合(パーセント)。小数第2位まで、ゼロから遠い方向への四捨五入です("37.42")。開示書類自身の次元のない数値であり、メンバーの合計ではありません。提出者が小計や連結のメンバーを加え、一部は未配分費用控除前のセグメント利益に連結の概念のタグを付けるため、メンバーの合計が100になるとは限りません。値と合計の符号が逆のとき(黒字企業の赤字セグメント)は負になり、連結が赤字の企業の赤字セグメントは正になります。その開示書類に同じ概念と期間の連結数値がない場合(たとえば合計が別の概念でタグ付けされている場合)、合計がゼロの場合、または通貨が異なる場合は省略されます。
segments[].restated_only常に true任意trueは、提出時の数値が保持されていないことを示します。この期間の報告書にそのメンバーがない場合(後の開示書類が期間を別のメンバーに区切り直したため)、または報告書がまだ読み込まれていない場合(期間がsegments_unreadにある)です。valueとfiling_idは省略され、restatedが唯一の数値、つまり後の開示書類の数値になり、後者の場合は修正再表示ですらないことがあります。報告書が読み込まれると、その行にvalueとfiling_idが加わります。
segments_unreadlist of date任意セグメント用に、その期間自身の報告書がまだ読み込まれていない期間の終了日。新しい順です。提出時の数値がないのは、提出がなかったという意味ではありません。それらの期間にある行はrestated_onlyで、後の開示書類から来ます。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0001260221/financials?segments=true&period=annual&fiscal_year=2024&statement=income"
レスポンスの例
{
  "id": "usa:0001260221",
  "currency": "USD",
  "annual": [
    {
      "fy": 2024,
      "end": "2024-09-30",
      "form": "10-K",
      "derived": [],
      "revenue": "7940000000",
      "gross_profit": "4672000000",
      "operating_income": "3531000000",
      "net_income": "1714000000"
    }
  ],
  "as_of": "2026-11-10",
  "segments": [
    {
      "end": "2024-09-30",
      "start": "2023-10-01",
      "measure": "revenue",
      "axis": "geography",
      "member": "country:US",
      "label": "UNITED STATES",
      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
      "value": "5032000000",
      "filing_id": "usa:0001260221:0001260221-24-000083",
      "currency": "USD",
      "percent_of_total": "63.38"
    },
    {
      "end": "2024-09-30",
      "start": "2023-10-01",
      "measure": "revenue",
      "axis": "segment",
      "member": "tdg:PowerAndControlMember",
      "label": "Power And Control [Member]",
      "concept": "us-gaap:Revenues",
      "value": "3941000000",
      "filing_id": "usa:0001260221:0001260221-24-000083",
      "currency": "USD",
      "percent_of_total": "49.63",
      "restated": {
        "value": "3966000000",
        "filing_id": "usa:0001260221:0001260221-25-000081",
        "percent_of_total": "49.95"
      }
    },
    {
      "end": "2024-09-30",
      "start": "2023-10-01",
      "measure": "revenue",
      "axis": "geography",
      "member": "country:US",
      "label": "UNITED STATES",
      "concept": "us-gaap:Revenues",
      "currency": "USD",
      "restated": {
        "value": "5032000000",
        "filing_id": "usa:0001260221:0001260221-25-000081",
        "percent_of_total": "63.38"
      },
      "restated_only": true
    },
    {
      "end": "2024-09-30",
      "measure": "assets",
      "axis": "segment",
      "member": "tdg:PowerAndControlMember",
      "label": "Power And Control [Member]",
      "concept": "us-gaap:Assets",
      "value": "9139000000",
      "filing_id": "usa:0001260221:0001260221-24-000083",
      "currency": "USD",
      "percent_of_total": "35.72",
      "restated": {
        "value": "9180000000",
        "filing_id": "usa:0001260221:0001260221-25-000014",
        "percent_of_total": "35.88"
      }
    }
  ]
}

エラー

エラーは共通の problem 形式で返され、次のコードを含みます: request_id。参照: APIエラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。

コードステータス意味
invalid_query400パラメータが欠けている、未知である、重複している、または範囲外です。
company_not_found404そのIDに一致する企業はありません。
filing_not_found404IDに一致する開示書類がない、または企業にそのフォームと期間の開示書類がありません。
item_not_found404開示書類にそのような項目がありません。企業を指定した8-Kでは、最新の8-K 10件のどれにもその項目がありません。
sections_unavailable404この開示書類のテキストは提供されていません。テキストがまだ読み込まれていない、米国の開示書類ではない、または項目を区別できなかったためです。
segments_unavailable404この企業のセグメントはまだ読み込まれていません。
not_covered404その市場、国、企業にはまだ対応していません。
insufficient_credits402クレジット残高が、リクエストの費用に足りません。
company_data_unavailable503この経路の元になる提出書類を、現在は読み取れません。しばらくしてからもう一度お試しください。

このページは役に立ちましたか?