مرجع API لنص الإفصاحات والقطاعات
نص الإفصاحات الأمريكية حسب البند، وأرقام القطاعات والمنتجات والمناطق
نظرة عامة
يُرجع نص الإفصاح ما كتبته شركة أمريكية في 10-K أو 10-Q أو 20-F أو 8-K، مقسّمًا عند عناوين البنود، مثل البند 1A (عوامل المخاطرة) أو البند 7 (مناقشة الإدارة). وتضيف القطاعات إلى قوائمها المالية الأرقام التي تقسّمها الشركة حسب القطاع أو المنتج أو المنطقة الجغرافية. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.
أربعة مسارات. يُرجع مساران نص إفصاح واحد: أحدهما بمعرّف الإفصاح، والآخر بالشركة والنموذج والسنة المالية. ويسرد مسار ثالث البنود التي يتضمنها كل نموذج. والرابع هو segments=true على مسار القوائم المالية، ويحتفظ باسمه وسعره. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193، ويُحدَّد الإفصاح بمعرّف شركته ونقطتين رأسيتين ورقم قيد الإفصاح لدى SEC.
يمتد السجل التاريخي خمس سنوات. الإفصاح الذي لم يُقرأ نصه بعد يُرجع 404 sections_، وتُدرج الفترة التي لم يُقرأ تقريرها الخاص للقطاعات بعد في segments_.
تخدم مسارات النص الولايات المتحدة واليابان وكوريا. الإفصاح الأمريكي هو 10-K أو 10-Q أو 20-F أو 8-K. والإفصاح الياباني هو YUHO أو HANKI أو SHIHANKI أو RINJI، والكوري هو 사업보고서 أو 반기보고서 أو 분기보고서. النموذج الذي يخص بلدًا غير بلد الشركة يُرجع 400 invalid_. والشركة من أي بلد آخر تُرجع 404 not_. والإفصاح الياباني أو الكوري الذي لم يُقرأ نصه بعد يُرجع 404 sections_. القطاعات للشركات الأمريكية فقط.
عنوان URL الأساسي: https:/. كل مسار أدناه أداة 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_، بمنزلتين عشريتين. لا يجمع الأعضاء دائمًا إلى 100، لأن مقدّمي الإفصاح يضيفون أعضاء المجاميع الفرعية والأعضاء الموحّدين. ويُحذف عندما لا يطبع الإفصاح رقمًا موحّدًا لذلك المفهوم والفترة.id - أرقام القطاعات بوحدات كاملة من
currency. والرقم في تاريخ معيّن، مثل الأصول أو الشهرة، ليس لهstart.
نقاط النهاية
كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.
احصل على نص إفصاح حسب البند
GET /v1/filings/{filing_id}/sections
نص إفصاح واحد، مقسّمًا عند عناوين البنود: كل البنود، أو بند واحد بـ item. إفصاح أمريكي 10-K أو 10-Q أو 20-F أو 8-K، أو تقرير ياباني أو كوري. والإفصاح الذي تعذّر تمييز بنوده يُرجع 404 sections_، ولا يُرجع نصًا جزئيًا أبدًا.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
filing_ | مسار | نعم | سلسلة نصية | معرّف الإفصاح: معرّف الشركة ونقطتان رأسيتان ورقم قيد الإفصاح لدى SEC، مثل usa:0000320193:0000320193-26-000026. يسردها Filings API. |
item | استعلام | لا | سلسلة نصية | بند واحد برقمه، مثل 1A أو 7. وبند 8-K يبدو مثل 2.02. وإذا حُذف أُرجعت كل البنود. والبند الذي ليس في الإفصاح يُرجع 404 item_. |
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_.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
company_ | مسار | نعم | سلسلة نصية | معرّف الشركة، مثل 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_. |
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_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
form | استعلام | لا | one of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서 | بنود نموذج واحد، من أي من القوائم الثلاث أعلاه. وبدونه، بنود النماذج الأمريكية الأربعة. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
items | قائمة كائنات | دائمًا | البنود، نموذجًا بعد نموذج. |
items[].form | one 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_ وas_ وversion بالطريقة نفسها.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
company_ | مسار | نعم | سلسلة نصية | معرّف الشركة، مثل usa:0000320193. يُقبل رمز تداول بديل مثل usa:AAPL. |
fields | استعلام | لا | سلسلة نصية | أسماء بنود قياسية مفصولة بفواصل، أو all. وبدونه، 15 بندًا شائعًا. |
statement | استعلام | لا | one of income, balance, cash_flow, per_share, shares, other | كل بنود قائمة واحدة: income أو balance أو cash_ أو per_ أو shares أو other. |
period | استعلام | لا | one of annual, semiannual, quarterly | annual افتراضيًا، أو semiannual أو quarterly، بقدر ما ينشره السجل. ليس للشركات الأمريكية تقارير نصف سنوية. |
fiscal_ | استعلام | لا | عدد صحيح | سنة مالية واحدة. |
basis | استعلام | لا | one of consolidated, standalone | consolidated أو standalone. |
version | استعلام | لا | one of latest, first_reported | latest افتراضيًا، أو first_. |
as_ | استعلام | لا | التاريخ | الأرقام كما كانت معروفة في هذا اليوم (YYYY-MM-DD). |
segments | استعلام | لا | منطقي | تضيف true الحقل segments: الإيرادات والدخل التشغيلي والأصول والنفقات الرأسمالية والاستهلاك والشهرة والأصول طويلة الأجل التي يقسّمها مقدّمو الإفصاح حسب القطاع أو المنتج أو المنطقة الجغرافية، للفترات الموجودة في الإجابة. التسميات هي تسميات الشركة نفسها، بلغة الإفصاح، ويحمل كل رقم currency. ويُعطى الرقم كما قُدِّم في تقرير فترته نفسها (value وfiling_)، وحيث غيّره إفصاح لاحق يُعطى restated مع ذلك الإفصاح؛ ويعطي version=first_ الأرقام كما قُدِّمت فقط. والفترة التي لم يُقرأ تقريرها للقطاعات بعد تُذكر في segments_، وتأتي صفوفها من إفصاحات لاحقة. والشركة من بلد لا يغطيه هذا التقسيم تُرجع 404 not_. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
id | سلسلة نصية | دائمًا | معرّف الإفصاح. وفي القوائم المالية، معرّف الشركة. |
currency | سلسلة نصية | اختياري | عملة مبالغ القوائم. |
basis | one of consolidated, standalone | اختياري | consolidated أو standalone. |
from_ | عدد صحيح | اختياري | أول سنة مالية تحتويها الإجابة، تُرسل عندما قُطع سجلها التاريخي. وتُحذف في غير ذلك. |
annual | قائمة كائنات | اختياري | الصفوف السنوية، من الأحدث. مفتاح الصف هو semiannual أو quarterly عندما يطلب ذلك period. وبنود الصف في صفحة Filings API. |
semiannual | قائمة كائنات | اختياري | الصفوف النصف سنوية، عندما يكون period=semiannual. |
quarterly | قائمة كائنات | اختياري | الصفوف الربع سنوية، عندما يكون period=quarterly. |
as_ | التاريخ | اختياري | اليوم الذي تُعد الأرقام كما هي فيه. |
segments | قائمة كائنات | اختياري | التقسيمات للفترات الموجودة في الإجابة، من أحدث فترة. تُحذف عندما لا تكون أي فترة قد قُرئت ولا يكون لأي إفصاح لاحق رقم. |
segments[].end | التاريخ | دائمًا | نهاية الفترة، أو تاريخ الرقم. |
segments[].start | التاريخ | اختياري | بداية الفترة. تُحذف للرقم في تاريخ معيّن، مثل الأصول أو الشهرة. |
segments[].measure | one of revenue, operating_income, assets, capex, depreciation, goodwill, long_lived_assets | دائمًا | ما يُقاس: revenue أو operating_ أو assets أو capex أو depreciation أو goodwill أو long_. |
segments[].axis | one of segment, product, geography | دائمًا | كيف تقسّمه الشركة: segment أو product أو geography. |
segments[].member | سلسلة نصية | دائمًا | اسم الشركة للقطاع أو المنتج أو المنطقة، كما وُسم في إفصاحها. |
segments[].label | سلسلة نصية | اختياري | صياغة الشركة نفسها للعضو. |
segments[].concept | سلسلة نصية | دائمًا | الوسم الذي استخدمته الشركة للرقم. |
segments[].value | سلسلة نصية | اختياري | الرقم كما قُدِّم في تقرير هذه الفترة (filing_). يُحذف للعضو restated_. |
segments[].filing_ | سلسلة نصية | اختياري | الإفصاح الذي قُدِّم فيه value: أول تقرير لهذه الفترة. |
segments[].currency | سلسلة نصية | دائمًا | عملة الرقم. |
segments[].percent_ | سلسلة نصية | اختياري | نسبة القيمة المئوية من رقم الشركة الموحّد للمفهوم والفترة والعملة نفسها في filing_، بمنزلتين عشريتين، بالتقريب بعيدًا عن الصفر ("37.42"). وهو رقم الإفصاح نفسه من دون أبعاد، وليس مجموع الأعضاء أبدًا: فمقدّمو الإفصاح يضيفون أعضاء المجاميع الفرعية والأعضاء الموحّدين، وبعضهم يضع المفهوم الموحّد على ربح القطاع قبل التكاليف غير الموزّعة، لذلك لا يجمع الأعضاء دائمًا إلى 100. وتكون سالبة عندما تختلف إشارة القيمة عن إشارة الإجمالي (قطاع خاسر في شركة رابحة)؛ وتكون موجبة لقطاع خاسر في شركة خسارتها موحّدة. وتُحذف عندما لا يطبع الإفصاح رقمًا موحّدًا لذلك المفهوم والفترة (مثلًا وُسم الإجمالي بمفهوم آخر)، أو عندما يكون الإجمالي صفرًا، أو تختلف العملتان. |
segments[].restated | كائن | اختياري | الرقم الذي يعطيه إفصاح لاحق، مع ذلك الإفصاح، حيث غيّر الرقم كما قُدِّم. وفي صف restated_ هو الرقم الوحيد المحفوظ، وقد لا يكون إعادة صياغة. |
segments[].restated.value | سلسلة نصية | دائمًا | الرقم المعاد صياغته، بوحدات كاملة من currency. |
segments[].restated.filing_ | سلسلة نصية | دائمًا | الإفصاح اللاحق الذي جاء منه الرقم المعاد صياغته. |
segments[].restated.percent_ | سلسلة نصية | اختياري | نسبة القيمة المئوية من رقم الشركة الموحّد للمفهوم والفترة والعملة نفسها في filing_، بمنزلتين عشريتين، بالتقريب بعيدًا عن الصفر ("37.42"). وهو رقم الإفصاح نفسه من دون أبعاد، وليس مجموع الأعضاء أبدًا: فمقدّمو الإفصاح يضيفون أعضاء المجاميع الفرعية والأعضاء الموحّدين، وبعضهم يضع المفهوم الموحّد على ربح القطاع قبل التكاليف غير الموزّعة، لذلك لا يجمع الأعضاء دائمًا إلى 100. وتكون سالبة عندما تختلف إشارة القيمة عن إشارة الإجمالي (قطاع خاسر في شركة رابحة)؛ وتكون موجبة لقطاع خاسر في شركة خسارتها موحّدة. وتُحذف عندما لا يطبع الإفصاح رقمًا موحّدًا لذلك المفهوم والفترة (مثلًا وُسم الإجمالي بمفهوم آخر)، أو عندما يكون الإجمالي صفرًا، أو تختلف العملتان. |
segments[].restated_ | دائمًا true | اختياري | تعني true أن لا رقم كما قُدِّم محفوظ: فتقرير هذه الفترة لا يضم العضو (إفصاح لاحق أعاد تقسيم الفترة إلى أعضاء آخرين)، أو لم يُحمَّل التقرير بعد (الفترة في segments_). يُحذف value وfiling_ ويكون restated هو الرقم الوحيد، وهو رقم إفصاح لاحق، وفي الحالة الثانية قد لا يكون إعادة صياغة أصلًا. وعندما يُحمَّل التقرير يكتسب الصف value وfiling_. |
segments_ | list of date | اختياري | تواريخ النهاية، من الأحدث، للفترات التي لم يُقرأ تقريرها الخاص للقطاعات بعد. أرقامها كما قُدِّمت مفقودة، وهذا لا يعني أنها لم تُقدَّم؛ وأي صفوف لها هي restated_، من إفصاحات لاحقة. |
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_. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.
| الرمز | الحالة | المعنى |
|---|---|---|
invalid_ | 400 | معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه. |
company_ | 404 | لا شركة تطابق المعرّف. |
filing_ | 404 | لا إفصاح يطابق المعرّف، أو ليس للشركة إفصاح من ذلك النموذج والفترة. |
item_ | 404 | ليس في الإفصاح هذا البند. وفي نموذج 8-K المطلوب بالشركة، لا يوجد البند في أي من أحدث 10 نماذج 8-K. |
sections_ | 404 | لا يُقدَّم نص لهذا الإفصاح: لم يُقرأ نصه بعد، أو ليس إفصاحًا أمريكيًا، أو تعذّر تمييز بنوده. |
segments_ | 404 | لم تُقرأ قطاعات هذه الشركة بعد. |
not_ | 404 | السوق أو البلد أو الشركة غير مغطى بعد. |
insufficient_ | 402 | رصيدك أقل من تكلفة الطلب. |
company_ | 503 | تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل. |
هل كانت هذه الصفحة مفيدة؟