Financial Data
Company fundamentals, financial statements, market prices and economic data.
تمام مالیاتی بیانات حاصل کریں
ایک کال میں ایک کمپنی کے تینوں بیانات۔ ایک financials آبجیکٹ واپس کرتا ہے جس میں income_statements، balance_sheets اور cash_flow_statements ہوتے ہیں، ہر ایک وہی شکل جو مخصوص ٹولز واپس کرتے ہیں۔ period درکار ہے (annual، quarterly یا ttm)؛ کمپنی کو ticker یا cik سے شناخت کریں اور limit سے حد مقرر کریں۔ جب آپ کو مکمل تصویر درکار ہو اور ورنہ تین کالیں کرنی پڑتیں تو اسے استعمال کریں۔ جب صرف ایک بیان درکار ہو، get_financial_financials_income_statements، get_financial_financials_balance_sheets یا get_financial_financials_cash_flow_statements کہیں کم ڈیٹا واپس کرتا ہے؛ جب کئی کمپنیوں میں مٹھی بھر نامزد فیلڈز درکار ہوں، post_financial_financials_search_line_items اس سے بھی زیادہ تنگ ہے۔
قیمت کا حوالہ
- میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: stringcik
کمپنی کا Central Index Key (CIK)۔
- قسم: stringcursor
پچھلے جواب کے next_page_url سے اوپیک پیجینیشن کرسر۔ فراہم کرنے پر دیگر تمام کوئری پیرامیٹرز نظر انداز کر دیے جاتے ہیں: کرسر اصل درخواست کے فلٹرز اٹھائے ہوئے ہوتا ہے۔ اسے اوپیک سمجھیں؛ اسے بنائیں یا تبدیل نہ کریں۔
- قسم: string فارمیٹ: datefiling
_date YYYY-MM-DD فارمیٹ میں عین SEC فلنگ تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔
- قسم: string فارمیٹ: datefiling
_date _gt YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے بڑی تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔
- قسم: string فارمیٹ: datefiling
_date _gte YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے بڑی یا اس کے برابر تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔
- قسم: string فارمیٹ: datefiling
_date _lt YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے چھوٹی تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔
- قسم: string فارمیٹ: datefiling
_date _lte YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے چھوٹی یا اس کے برابر تاریخ کے مطابق فلٹر کریں۔ پوائنٹ-ان-ٹائم کوئریز کے لیے مفید: صرف وہ ڈیٹا واپس کرتا ہے جو دی گئی تاریخ تک عوامی طور پر فائل کیا گیا ہو۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔
- قسم: integer فارمیٹ: int32limit
واپس کرنے والے مالیاتی گوشواروں کی زیادہ سے زیادہ تعداد۔ یہ تمام صفحات کا مجموعہ ہے، صفحہ کا سائز نہیں: ہر صفحہ زیادہ سے زیادہ 10 ریکارڈ رکھتا ہے، جو
next_page_urlسے منسلک ہوتے ہیں۔ - قسم: string enumperiodلازمی
مالیاتی گوشواروں کا زمانی دور۔
اقدار- annual
- quarterly
- ttm
- قسم: string فارمیٹ: datereport
_period YYYY-MM-DD فارمیٹ میں عین رپورٹ دور کی تاریخ کے مطابق فلٹر کریں۔
- قسم: string فارمیٹ: datereport
_period _gt YYYY-MM-DD فارمیٹ میں تاریخ سے بڑے رپورٹ دور کے مطابق فلٹر کریں۔
- قسم: string فارمیٹ: datereport
_period _gte YYYY-MM-DD فارمیٹ میں تاریخ سے بڑے یا اس کے برابر رپورٹ دور کے مطابق فلٹر کریں۔
- قسم: string فارمیٹ: datereport
_period _lt YYYY-MM-DD فارمیٹ میں تاریخ سے چھوٹے رپورٹ دور کے مطابق فلٹر کریں۔
- قسم: string فارمیٹ: datereport
_period _lte YYYY-MM-DD فارمیٹ میں تاریخ سے چھوٹے یا اس کے برابر رپورٹ دور کے مطابق فلٹر کریں۔
- قسم: stringticker
ٹکر سمبل۔ اگر cik فراہم نہ کیا جائے تو درکار۔
- قسم: object · ResponseE40Feb4D3D6B_FinancialsResponse200
مالیاتی بیانات کا جواب
- قسم: objectfinancials
- balanceقسم: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accessionقسم: string | null
_number فائلنگ کا SEC ایکسیشن نمبر۔
- accumulatedقسم: number
_other _comprehensive _income کمپنی کی جمع شدہ دیگر جامع آمدنی۔
- cashقسم: number
_and _equivalents کمپنی کی نقدی اور مساوی اشیاء۔
- currencyقسم: string
وہ کرنسی جس میں مالیاتی ڈیٹا رپورٹ کیا جاتا ہے۔
- currentقسم: number
_assets کمپنی کے موجودہ اثاثے۔
- currentقسم: number
_debt کمپنی کا موجودہ قرض۔
- currentقسم: number
_investments کمپنی کی موجودہ سرمایہ کاری۔
- currentقسم: number
_liabilities کمپنی کی موجودہ واجبات۔
- deferredقسم: number
_revenue کمپنی کی موخر آمدنی۔
- depositقسم: number
_liabilities کمپنی کی ڈپازٹ واجبات۔
- filingقسم: string | null فارمیٹ: date
_date وہ کیلنڈر دن جب SEC نے فائلنگ قبول کی، مشرقی وقت (Eastern Time) میں (SEC کا آپریٹنگ ٹائم زون)۔
filing_datetimeکا کیلنڈر دن جوڑا۔ null جب قطار سے کوئی تاریخ والی SEC فائلنگ منسلک نہ ہو۔ - filingقسم: string | null فارمیٹ: date-time
_datetime ذیلی دن کا ٹائم اسٹیمپ جو ریکارڈ کرتا ہے کہ SEC نے فائلنگ کب قبول کی، مشرقی وقت میں۔ EDGAR submissions API پر SEC کے
acceptanceDateTimeفیلڈ سے حاصل کیا گیا۔filing_dateکے ساتھ جوڑا بناتا ہے (اسی واقعے کی کیلنڈر دن کی درستگی)۔ - filingقسم: string | null فارمیٹ: uri
_url SEC فائلنگ کا URL۔
- fiscalقسم: string
_period بیلنس شیٹ کی مالی مدت۔
- formقسم: string | null
_type وہ SEC فارم جس سے یہ قطار لی گئی (
10-K،10-Q/A،20-F،S-1، ...)۔ بالکل وہی فارم جیسا فائل کیا گیا، اس لیے ترامیم اپنا/Aلاحقہ برقرار رکھتی ہیں۔ null جبperiodکی قدرttmہو: گزشتہ بارہ ماہ کی ونڈو متعدد فائلنگز پر پھیل سکتی ہے، اس لیے ہم اسے کسی ایک سے منسوب نہیں کرتے۔quarterlyقطار10-Kرکھ سکتی ہے جب چوتھی سہ ماہی مالی سال کی فائلنگ سے اخذ کی گئی ہو۔ - goodwillقسم: number
_and _intangible _assets کمپنی کی گڈول اور غیر محسوس اثاثے۔
- inventoryقسم: number
کمپنی کا انوینٹری۔
- investmentsقسم: number
کمپنی کی سرمایہ کاری۔
- nonقسم: number
_current _assets کمپنی کے غیر موجودہ اثاثے۔
- nonقسم: number
_current _debt کمپنی کا غیر موجودہ قرض۔
- nonقسم: number
_current _investments کمپنی کی غیر موجودہ سرمایہ کاری۔
- nonقسم: number
_current _liabilities کمپنی کی غیر موجودہ واجبات۔
- outstandingقسم: number
_shares کمپنی کے بقایا حصص۔
- periodقسم: string enum
بیلنس شیٹ کی مدت۔
اقدار- quarterly
- ttm
- annual
- propertyقسم: number
_plant _and _equipment کمپنی کی جائیداد، پلانٹ اور آلات۔
- reportقسم: string فارمیٹ: date
_period بیلنس شیٹ کی رپورٹنگ مدت۔
- retainedقسم: number
_earnings کمپنی کی برقرار رکھی گئی آمدنی۔
- shareholdersقسم: number
_equity کمپنی کی شیئر ہولڈرز ایکویٹی۔
- taxقسم: number
_assets کمپنی کے ٹیکس اثاثے۔
- taxقسم: number
_liabilities کمپنی کی ٹیکس واجبات۔
- tickerقسم: string
ٹکر سمبل۔
- totalقسم: number
_assets کمپنی کے کل اثاثے۔
- totalقسم: number
_debt کمپنی کا کل قرض۔
- totalقسم: number
_liabilities کمپنی کی کل واجبات۔
- tradeقسم: number
_and _non _trade _payables کمپنی کے تجارتی اور غیر تجارتی قابل ادائیگی۔
- tradeقسم: number
_and _non _trade _receivables کمپنی کی تجارتی اور غیر تجارتی وصولیاں۔
- cashقسم: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accessionقسم: string | null
_number فائلنگ کا SEC ایکسیشن نمبر۔
- businessقسم: number
_acquisitions _and _disposals کمپنی کے کاروباری حصول اور تصرفات۔
- capitalقسم: number
_expenditure کمپنی کا کیپیٹل ایکسپنڈیچر۔
- changeقسم: number
_in _cash _and _equivalents کمپنی کی نقدی اور مساوی اشیاء میں تبدیلی۔
- currencyقسم: string
وہ کرنسی جس میں مالیاتی ڈیٹا رپورٹ کیا جاتا ہے۔
- depreciationقسم: number
_and _amortization کمپنی کی فرسودگی اور امورٹائزیشن۔
- dividendsقسم: number
_and _other _cash _distributions کمپنی کے ڈیویڈنڈ اور دیگر نقد تقسیمات۔
- effectقسم: number
_of _exchange _rate _changes کمپنی پر شرح مبادلہ تبدیلیوں کا اثر۔
- endingقسم: number
_cash _balance کمپنی کا اختتامی نقدی بیلنس۔
- filingقسم: string | null فارمیٹ: date
_date وہ کیلنڈر دن جب SEC نے فائلنگ قبول کی، مشرقی وقت (Eastern Time) میں (SEC کا آپریٹنگ ٹائم زون)۔
filing_datetimeکا کیلنڈر دن جوڑا۔ null جب قطار سے کوئی تاریخ والی SEC فائلنگ منسلک نہ ہو۔ - filingقسم: string | null فارمیٹ: date-time
_datetime ذیلی دن کا ٹائم اسٹیمپ جو ریکارڈ کرتا ہے کہ SEC نے فائلنگ کب قبول کی، مشرقی وقت میں۔ EDGAR submissions API پر SEC کے
acceptanceDateTimeفیلڈ سے حاصل کیا گیا۔filing_dateکے ساتھ جوڑا بناتا ہے (اسی واقعے کی کیلنڈر دن کی درستگی)۔ - filingقسم: string | null فارمیٹ: uri
_url SEC فائلنگ کا URL۔
- fiscalقسم: string
_period کیش فلو اسٹیٹمنٹ کی مالی مدت۔
- formقسم: string | null
_type وہ SEC فارم جس سے یہ قطار لی گئی (
10-K،10-Q/A،20-F،S-1، ...)۔ بالکل وہی فارم جیسا فائل کیا گیا، اس لیے ترامیم اپنا/Aلاحقہ برقرار رکھتی ہیں۔ null جبperiodکی قدرttmہو: گزشتہ بارہ ماہ کی ونڈو متعدد فائلنگز پر پھیل سکتی ہے، اس لیے ہم اسے کسی ایک سے منسوب نہیں کرتے۔quarterlyقطار10-Kرکھ سکتی ہے جب چوتھی سہ ماہی مالی سال کی فائلنگ سے اخذ کی گئی ہو۔ - freeقسم: number
_cash _flow کمپنی کا آزاد کیش فلو۔
- investmentقسم: number
_acquisitions _and _disposals کمپنی کے سرمایہ کاری کے حصول اور تصرفات۔
- issuanceقسم: number
_or _purchase _of _equity _shares کمپنی کے ایکویٹی حصص کا اجراء یا خریداری۔
- issuanceقسم: number
_or _repayment _of _debt _securities کمپنی کی قرضہ سیکیورٹیز کا اجراء یا ادائیگی۔
- netقسم: number
_cash _flow _from _financing کمپنی کا فنانسنگ سے خالص کیش فلو۔
- netقسم: number
_cash _flow _from _investing کمپنی کا سرمایہ کاری سے خالص کیش فلو۔
- netقسم: number
_cash _flow _from _operations کمپنی کا آپریشنز سے خالص کیش فلو۔
- netقسم: number
_income کمپنی کی خالص آمدنی۔
- periodقسم: string enum
کیش فلو اسٹیٹمنٹ کی مدت۔
اقدار- quarterly
- ttm
- annual
- reportقسم: string فارمیٹ: date
_period کیش فلو اسٹیٹمنٹ کی رپورٹنگ مدت۔
- shareقسم: number
_based _compensation کمپنی کا شیئر پر مبنی معاوضہ۔
- tickerقسم: string
ٹکر سمبل۔
- incomeقسم: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accessionقسم: string | null
_number فائلنگ کا SEC ایکسیشن نمبر۔
- consolidatedقسم: number
_income کمپنی کی یکجا آمدنی۔
- costقسم: number
_of _revenue کمپنی کی آمدنی کی لاگت۔
- currencyقسم: string
وہ کرنسی جس میں مالیاتی ڈیٹا رپورٹ کیا جاتا ہے۔
- dividendsقسم: number
_per _common _share کمپنی کے فی عام حصص ڈیویڈنڈ۔
- earningsقسم: number
_per _share کمپنی کی فی حصص کمائی۔
- earningsقسم: number
_per _share _diluted کمپنی کی ڈائلوٹڈ فی حصص کمائی۔
- ebitقسم: number
کمپنی کی سود اور ٹیکس سے قبل کمائی۔
- filingقسم: string | null فارمیٹ: date
_date وہ کیلنڈر دن جب SEC نے فائلنگ قبول کی، مشرقی وقت (Eastern Time) میں (SEC کا آپریٹنگ ٹائم زون)۔
filing_datetimeکا کیلنڈر دن جوڑا۔ null جب قطار سے کوئی تاریخ والی SEC فائلنگ منسلک نہ ہو۔ - filingقسم: string | null فارمیٹ: date-time
_datetime ذیلی دن کا ٹائم اسٹیمپ جو ریکارڈ کرتا ہے کہ SEC نے فائلنگ کب قبول کی، مشرقی وقت میں۔ EDGAR submissions API پر SEC کے
acceptanceDateTimeفیلڈ سے حاصل کیا گیا۔filing_dateکے ساتھ جوڑا بناتا ہے (اسی واقعے کی کیلنڈر دن کی درستگی)۔ - filingقسم: string | null فارمیٹ: uri
_url SEC فائلنگ کا URL۔
- fiscalقسم: string
_period انکم اسٹیٹمنٹ کی مالی مدت۔
- formقسم: string | null
_type وہ SEC فارم جس سے یہ قطار لی گئی (
10-K،10-Q/A،20-F،S-1، ...)۔ بالکل وہی فارم جیسا فائل کیا گیا، اس لیے ترامیم اپنا/Aلاحقہ برقرار رکھتی ہیں۔ null جبperiodکی قدرttmہو: گزشتہ بارہ ماہ کی ونڈو متعدد فائلنگز پر پھیل سکتی ہے، اس لیے ہم اسے کسی ایک سے منسوب نہیں کرتے۔quarterlyقطار10-Kرکھ سکتی ہے جب چوتھی سہ ماہی مالی سال کی فائلنگ سے اخذ کی گئی ہو۔ - grossقسم: number
_profit کمپنی کا مجموعی منافع۔
- incomeقسم: number
_tax _expense کمپنی کے انکم ٹیکس کے اخراجات۔
- interestقسم: number
_expense کمپنی کے سود کے اخراجات۔
- netقسم: number
_income کمپنی کی خالص آمدنی۔
- netقسم: number
_income _common _stock کمپنی کے عام شیئر ہولڈرز کے لیے دستیاب خالص آمدنی۔
- netقسم: number
_income _discontinued _operations کمپنی کے بند شدہ آپریشنز سے خالص آمدنی۔
- netقسم: number
_income _non _controlling _interests کمپنی کے غیر کنٹرولنگ مفادات سے خالص آمدنی۔
- operatingقسم: number
_expense کمپنی کے آپریٹنگ اخراجات۔
- operatingقسم: number
_income کمپنی کی آپریٹنگ آمدنی۔
- periodقسم: string enum
انکم اسٹیٹمنٹ کی زمانی مدت۔
اقدار- quarterly
- ttm
- annual
- preferredقسم: number
_dividends _impact کمپنی کی خالص آمدنی پر ترجیحی ڈیویڈنڈ کا اثر۔
- reportقسم: string فارمیٹ: date
_period انکم اسٹیٹمنٹ کی رپورٹنگ مدت۔
- researchقسم: number
_and _development کمپنی کے تحقیق و ترقی کے اخراجات۔
- revenueقسم: number
کمپنی کی کل آمدنی۔
- sellingقسم: number
_general _and _administrative _expenses کمپنی کے فروخت، عمومی اور انتظامی اخراجات۔
- tickerقسم: string
ٹکر سمبل۔
- weightedقسم: number
_average _shares کمپنی کے وزنی اوسط حصص۔
- weightedقسم: number
_average _shares _diluted کمپنی کے ڈائلوٹڈ وزنی اوسط حصص۔
- قسم: stringnext
_page _url نتائج کے اگلے صفحے کا مطلق URL۔ صرف اس وقت موجود جب مزید نتائج باقی ہوں؛ جاری رکھنے کے لیے اسے جوں کا توں درخواست کریں۔ ہر صفحے میں زیادہ سے زیادہ 10 ریکارڈز ہوتے ہیں۔
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"financials": {
"income_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"revenue": 1,
"cost_of_revenue": 1,
"gross_profit": 1,
"operating_expense": 1,
"selling_general_and_administrative_expenses": 1,
"research_and_development": 1,
"operating_income": 1,
"interest_expense": 1,
"ebit": 1,
"income_tax_expense": 1,
"net_income_discontinued_operations": 1,
"net_income_non_controlling_interests": 1,
"net_income": 1,
"net_income_common_stock": 1,
"preferred_dividends_impact": 1,
"consolidated_income": 1,
"earnings_per_share": 1,
"earnings_per_share_diluted": 1,
"dividends_per_common_share": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1
}
],
"balance_sheets": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"total_assets": 1,
"current_assets": 1,
"cash_and_equivalents": 1,
"inventory": 1,
"current_investments": 1,
"trade_and_non_trade_receivables": 1,
"non_current_assets": 1,
"property_plant_and_equipment": 1,
"goodwill_and_intangible_assets": 1,
"investments": 1,
"non_current_investments": 1,
"outstanding_shares": 1,
"tax_assets": 1,
"total_liabilities": 1,
"current_liabilities": 1,
"current_debt": 1,
"trade_and_non_trade_payables": 1,
"deferred_revenue": 1,
"deposit_liabilities": 1,
"non_current_liabilities": 1,
"non_current_debt": 1,
"tax_liabilities": 1,
"shareholders_equity": 1,
"retained_earnings": 1,
"accumulated_other_comprehensive_income": 1,
"total_debt": 1
}
],
"cash_flow_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"net_income": 1,
"depreciation_and_amortization": 1,
"share_based_compensation": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"business_acquisitions_and_disposals": 1,
"investment_acquisitions_and_disposals": 1,
"net_cash_flow_from_investing": 1,
"issuance_or_repayment_of_debt_securities": 1,
"issuance_or_purchase_of_equity_shares": 1,
"dividends_and_other_cash_distributions": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"effect_of_exchange_rate_changes": 1,
"ending_cash_balance": 1,
"free_cash_flow": 1
}
]
},
"next_page_url": "string"
}