تصفّح التوثيق كاملًا

مرجع API لنص الإفصاحات والقطاعات

نص الإفصاحات الأمريكية حسب البند، وأرقام القطاعات والمنتجات والمناطق

نظرة عامة

يُرجع نص الإفصاح ما كتبته شركة أمريكية في 10-K أو 10-Q أو 20-F أو 8-K، مقسّمًا عند عناوين البنود، مثل البند 1A (عوامل المخاطرة) أو البند 7 (مناقشة الإدارة). وتضيف القطاعات إلى قوائمها المالية الأرقام التي تقسّمها الشركة حسب القطاع أو المنتج أو المنطقة الجغرافية. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.

أربعة مسارات. يُرجع مساران نص إفصاح واحد: أحدهما بمعرّف الإفصاح، والآخر بالشركة والنموذج والسنة المالية. ويسرد مسار ثالث البنود التي يتضمنها كل نموذج. والرابع هو segments=true على مسار القوائم المالية، ويحتفظ باسمه وسعره. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193، ويُحدَّد الإفصاح بمعرّف شركته ونقطتين رأسيتين ورقم قيد الإفصاح لدى SEC.

يمتد السجل التاريخي خمس سنوات. الإفصاح الذي لم يُقرأ نصه بعد يُرجع 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 قائمة بذاتها، بالمعاملات نفسها.

صفوف كل قائمة مالية في مرجع filings API للقوائم المالية والإفصاحات.

معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.

ما يحصل عليه كل حساب

ماكل حساب
نص الإفصاح، مسارانمشمول
قائمة البنودمشمول، مجاني
القطاعات في البيانات الماليةمشمول

راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.

  • يُحاسَب بسعر Companies، 10 دولارات لكل 1,000 استدعاء. كل إجابة نصية ناجحة استدعاء واحد، مهما كان البند أو الحجم أو الصيغة. ونموذج 8-K بحسب الشركة، الذي يقرأ حتى أحدث 10 نماذج 8-K للعثور على بند، يظل استدعاءً واحدًا. الإجابة الفارغة مجانية، وفي مسارات النص يُرجع عدم العثور على شيء 404، وهو مجاني أيضًا. قائمة البنود مجانية. لا تُحاسَب الأخطاء.
  • segments=true لا يضيف استدعاءً ولا سعرًا. القوائم المالية معه استدعاء واحد، كما هي من دونه. والإجابة التي فيها صفوف مالية تُحاسَب كاستدعاء واحد، سواء كان في segments صفوف أو كان فارغًا أو محذوفًا.
  • النص هو نص الإفصاح نفسه مقسّمًا عند عناوين بنوده. لا يُعاد كتابته ولا يُلخَّص. والإفصاح الذي تعذّر تمييز بنوده يُرجع 404 sections_unavailable، ولا يُرجع نصًا جزئيًا أبدًا.
  • في 10-Q يوجد Item 1 في Part I وItem 1 آخر في Part II. وبدون part يُرجع item=1 كليهما.
  • يُرجع نموذج 8-K بدون item نص مرفقاته أيضًا، في 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 واحد منفصلين، مثل الإيرادات مع المبيعات بين القطاعات وبدونها.
  • percent_of_total هو الرقم كنسبة مئوية من رقم الشركة الموحّد للمفهوم والفترة نفسيهما في الإفصاح المحدد بـ filing_id، بمنزلتين عشريتين. لا يجمع الأعضاء دائمًا إلى 100، لأن مقدّمي الإفصاح يضيفون أعضاء المجاميع الفرعية والأعضاء الموحّدين. ويُحذف عندما لا يطبع الإفصاح رقمًا موحّدًا لذلك المفهوم والفترة.
  • أرقام القطاعات بوحدات كاملة من currency. والرقم في تاريخ معيّن، مثل الأصول أو الشهرة، ليس له start.

نقاط النهاية

كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

احصل على نص إفصاح حسب البند

GET /v1/filings/{filing_id}/sections

نص إفصاح واحد، مقسّمًا عند عناوين البنود: كل البنود، أو بند واحد بـ item. إفصاح أمريكي 10-K أو 10-Q أو 20-F أو 8-K، أو تقرير ياباني أو كوري. والإفصاح الذي تعذّر تمييز بنوده يُرجع 404 sections_unavailable، ولا يُرجع نصًا جزئيًا أبدًا.

MCP: الأداة filings_get_sections.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
filing_idمسارنعمسلسلة نصيةمعرّف الإفصاح: معرّف الشركة ونقطتان رأسيتان ورقم قيد الإفصاح لدى SEC، مثل usa:0000320193:0000320193-26-000026. يسردها Filings API.
itemاستعلاملاسلسلة نصيةبند واحد برقمه، مثل 1A أو 7. وبند 8-K يبدو مثل 2.02. وإذا حُذف أُرجعت كل البنود. والبند الذي ليس في الإفصاح يُرجع 404 item_not_found.
partاستعلاملاسلسلة نصيةالجزء (I إلى IV). في 10-Q يوجد Item 1 في Part I وItem 1 آخر في Part II؛ وبدون part يُرجع item كليهما.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الإفصاح. وفي القوائم المالية، معرّف الشركة.
formسلسلة نصيةدائمًانموذج الإفصاح، مثل 10-K.
sectionsقائمة كائناتدائمًابنود الإفصاح، بترتيب الإفصاح.
sections[].itemسلسلة نصيةدائمًارقم البند، مثل 1A، أو 2.02 في 8-K.
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

النص نفسه كما في مسار الإفصاح، يُعثر عليه بالشركة والنموذج والسنة المالية، فلا حاجة إلى معرّف إفصاح. وبدون year يكون أحدث إفصاح من ذلك النموذج. وفي 8-K مع item، يكون أحدث إفصاح من آخر 10 نماذج 8-K للشركة يحتوي على البند.

استخدم quarter مع form=10-Q لاختيار ربع. ومع أي نموذج آخر يُرجع 400 invalid_query.

MCP: الأداة filings_get_company_sections.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
company_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استعلاملاسلسلة نصيةبند واحد، مثل 1A. وفي 8-K تكون الإجابة أحدث إفصاح من آخر 10 نماذج 8-K للشركة يحتوي على البند (يبلّغ نموذج 8-K عن حدث واحد، لذلك كثيرًا ما يخلو أحدثها منه)؛ وبدون item يكون أحدث 8-K.
partاستعلاملاسلسلة نصيةالجزء، من I إلى IV. في 10-Q يوجد Item 1 في Part I وItem 1 آخر في Part II؛ وبدون part يُرجع item كليهما.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الإفصاح. وفي القوائم المالية، معرّف الشركة.
formسلسلة نصيةدائمًانموذج الإفصاح، مثل 10-K.
sectionsقائمة كائناتدائمًابنود الإفصاح، بترتيب الإفصاح.
sections[].itemسلسلة نصيةدائمًارقم البند، مثل 1A، أو 2.02 في 8-K.
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

البنود التي يمكن أن تُرجعها مسارات النص لكل نموذج: البند والجزء والعنوان. مجاني: لا يُحاسَب هذا المسار.

اطلب البنود أولًا، ثم مرّر أحدها بوصفه item في مسارات النص.

MCP: الأداة filings_list_section_items.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
formاستعلاملاone of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서بنود نموذج واحد، من أي من القوائم الثلاث أعلاه. وبدونه، بنود النماذج الأمريكية الأربعة.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
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 إلى إجابة القوائم المالية: الإيرادات والدخل التشغيلي والأصول والنفقات الرأسمالية والاستهلاك والشهرة والأصول طويلة الأجل التي تقسّمها الشركة حسب القطاع أو المنتج أو المنطقة الجغرافية. وهو المسار نفسه والسعر نفسه كالقوائم المالية بدونه. وصفوف كل قائمة في صفحة Filings API.

بدون segments=true يكون هذا مسار القوائم المالية في Filings API ولا يكون في الإجابة segments. ومعه يُرسل segments عندما تعطي فترة أو إفصاح لاحق رقمًا. تأتي أحدث فترة أولًا، وتأتي الإيرادات قبل المقاييس الأخرى.

تتبع القطاعات الفترات الموجودة في الإجابة، لذلك تقصّها period وfiscal_year وas_of وversion بالطريقة نفسها.

MCP: الأداة filings_get_financials.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
company_idمسارنعمسلسلة نصيةمعرّف الشركة، مثل usa:0000320193. يُقبل رمز تداول بديل مثل usa:AAPL.
fieldsاستعلاملاسلسلة نصيةأسماء بنود قياسية مفصولة بفواصل، أو all. وبدونه، 15 بندًا شائعًا.
statementاستعلاملاone of income, balance, cash_flow, per_share, shares, otherكل بنود قائمة واحدة: income أو balance أو cash_flow أو per_share أو shares أو other.
periodاستعلاملاone of annual, semiannual, quarterlyannual افتراضيًا، أو semiannual أو quarterly، بقدر ما ينشره السجل. ليس للشركات الأمريكية تقارير نصف سنوية.
fiscal_yearاستعلاملاعدد صحيحسنة مالية واحدة.
basisاستعلاملاone of consolidated, standaloneconsolidated أو standalone.
versionاستعلاملاone of latest, first_reportedlatest افتراضيًا، أو first_reported.
as_ofاستعلاملاالتاريخالأرقام كما كانت معروفة في هذا اليوم (YYYY-MM-DD).
segmentsاستعلاملامنطقيتضيف true الحقل segments: الإيرادات والدخل التشغيلي والأصول والنفقات الرأسمالية والاستهلاك والشهرة والأصول طويلة الأجل التي يقسّمها مقدّمو الإفصاح حسب القطاع أو المنتج أو المنطقة الجغرافية، للفترات الموجودة في الإجابة. التسميات هي تسميات الشركة نفسها، بلغة الإفصاح، ويحمل كل رقم currency. ويُعطى الرقم كما قُدِّم في تقرير فترته نفسها (value وfiling_id)، وحيث غيّره إفصاح لاحق يُعطى restated مع ذلك الإفصاح؛ ويعطي version=first_reported الأرقام كما قُدِّمت فقط. والفترة التي لم يُقرأ تقريرها للقطاعات بعد تُذكر في segments_unread، وتأتي صفوفها من إفصاحات لاحقة. والشركة من بلد لا يغطيه هذا التقسيم تُرجع 404 not_covered.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الإفصاح. وفي القوائم المالية، معرّف الشركة.
currencyسلسلة نصيةاختياريعملة مبالغ القوائم.
basisone of consolidated, standaloneاختياريconsolidated أو standalone.
from_fyعدد صحيحاختياريأول سنة مالية تحتويها الإجابة، تُرسل عندما قُطع سجلها التاريخي. وتُحذف في غير ذلك.
annualقائمة كائناتاختياريالصفوف السنوية، من الأحدث. مفتاح الصف هو semiannual أو quarterly عندما يطلب ذلك period. وبنود الصف في صفحة Filings 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، بمنزلتين عشريتين، بالتقريب بعيدًا عن الصفر ("37.42"). وهو رقم الإفصاح نفسه من دون أبعاد، وليس مجموع الأعضاء أبدًا: فمقدّمو الإفصاح يضيفون أعضاء المجاميع الفرعية والأعضاء الموحّدين، وبعضهم يضع المفهوم الموحّد على ربح القطاع قبل التكاليف غير الموزّعة، لذلك لا يجمع الأعضاء دائمًا إلى 100. وتكون سالبة عندما تختلف إشارة القيمة عن إشارة الإجمالي (قطاع خاسر في شركة رابحة)؛ وتكون موجبة لقطاع خاسر في شركة خسارتها موحّدة. وتُحذف عندما لا يطبع الإفصاح رقمًا موحّدًا لذلك المفهوم والفترة (مثلًا وُسم الإجمالي بمفهوم آخر)، أو عندما يكون الإجمالي صفرًا، أو تختلف العملتان.
segments[].restatedكائناختياريالرقم الذي يعطيه إفصاح لاحق، مع ذلك الإفصاح، حيث غيّر الرقم كما قُدِّم. وفي صف restated_only هو الرقم الوحيد المحفوظ، وقد لا يكون إعادة صياغة.
segments[].restated.valueسلسلة نصيةدائمًاالرقم المعاد صياغته، بوحدات كاملة من currency.
segments[].restated.filing_idسلسلة نصيةدائمًاالإفصاح اللاحق الذي جاء منه الرقم المعاد صياغته.
segments[].restated.percent_of_totalسلسلة نصيةاختيارينسبة القيمة المئوية من رقم الشركة الموحّد للمفهوم والفترة والعملة نفسها في filing_id، بمنزلتين عشريتين، بالتقريب بعيدًا عن الصفر ("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"
      }
    }
  ]
}

الأخطاء

تستخدم الأخطاء بنية المشكلة المشتركة مع: request_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.

الرمزالحالةالمعنى
invalid_query400معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
company_not_found404لا شركة تطابق المعرّف.
filing_not_found404لا إفصاح يطابق المعرّف، أو ليس للشركة إفصاح من ذلك النموذج والفترة.
item_not_found404ليس في الإفصاح هذا البند. وفي نموذج 8-K المطلوب بالشركة، لا يوجد البند في أي من أحدث 10 نماذج 8-K.
sections_unavailable404لا يُقدَّم نص لهذا الإفصاح: لم يُقرأ نصه بعد، أو ليس إفصاحًا أمريكيًا، أو تعذّر تمييز بنوده.
segments_unavailable404لم تُقرأ قطاعات هذه الشركة بعد.
not_covered404السوق أو البلد أو الشركة غير مغطى بعد.
insufficient_credits402رصيدك أقل من تكلفة الطلب.
company_data_unavailable503تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل.

هل كانت هذه الصفحة مفيدة؟