Financial Data
Company fundamentals, financial statements, market prices and economic data.
SEC فائلنگ آئٹمز حاصل کریں
ایک SEC فائلنگ کے اندر شمار شدہ آئٹمز کا مکمل متن۔ ticker، filing_type (10-K، 10-Q یا 8-K) اور year سب درکار ہیں؛ quarter، item، accession_number یا include_exhibits سے مزید تنگ کریں۔ items واپس کرتا ہے — ہر ایک میں number، title اور مکمل text — نیز filing_url اور accession_number۔ حجم کا خیال رکھیں: 10-K تقریباً 19 آئٹمز کے مکمل نثر کی صورت میں آتا ہے، لہٰذا پوری دستاویز واقعی درکار نہ ہو تو سب کچھ کھینچنے کے بجائے مخصوص item مانگیں۔ پہلے یہ جاننے کے لیے کہ کون سی فائلنگ کھولنی ہے، get_financial_filings استعمال کریں۔
قیمت کا حوالہ
- میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: stringaccession
_number اگر 8-K ہو تو فلنگ کا الحاقی نمبر۔
- قسم: string enumfiling
_type لازمیفلنگ کی قسم۔
اقدار- 10
- K - 10
- Q - 8
- K
- قسم: booleaninclude
_exhibits لنک شدہ ایگزیبٹس سے خام متن شامل کرنا ہے یا نہیں۔ صرف 8-K فلنگز پر لاگو ہے۔ true ہونے پر ایگزیبٹ آبجیکٹس میں 'text' فیلڈ شامل ہوگی جس میں ایگزیبٹ کا مکمل مواد ہوگا۔
- قسم: string enumitem
حاصل کرنے کے لیے آئٹم۔
اقدار- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- قسم: integerquarter
اگر 10-Q ہو تو فلنگ کی سہ ماہی۔
- قسم: stringtickerلازمی
ٹکر سمبل۔
- قسم: integeryearلازمی
فلنگ کا سال۔
- قسم: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
SEC فائلنگ آئٹمز کا جواب
- قسم: stringaccession
_number فائلنگ کا ایکسیشن نمبر۔
- قسم: stringcik
کمپنی کا Central Index Key (CIK)۔
- قسم: stringfiling
_type فلنگ کی قسم۔
- قسم: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibitsقسم: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
اس آئٹم سے منسلک ایگزیبٹس کی صف۔ صرف 8-K فائلنگز کے لیے موجود جب ایگزیبٹس ہوں۔
- descriptionقسم: string
ایگزیبٹ کی تفصیل۔
- numberقسم: string
ایگزیبٹ نمبر (مثلاً '99.1')۔
- textقسم: string
ایگزیبٹ کا خام متنی مواد۔ صرف اس وقت شامل کیا جاتا ہے جب 'include_exhibits' پیرامیٹر true پر سیٹ ہو۔
- urlقسم: string فارمیٹ: uri
SEC ویب سائٹ پر ایگزیبٹ دستاویز کا URL۔
- nameقسم: string
آئٹم کا نام۔
- numberقسم: string
آئٹم نمبر۔
- textقسم: string
آئٹم کا متن۔
- قسم: integerquarter
فائلنگ کی سہ ماہی۔
- قسم: stringresource
ریسورس کی قسم کا شناخت کنندہ۔
- قسم: stringticker
کمپنی کا ٹکر سمبل۔
- قسم: integeryear
فلنگ کا سال۔
application/json - قسم: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
فائلنگ ابھی تیار ہو رہی ہے۔ نتیجہ حاصل کرنے کے لیے جواب کے باڈی میں result_url کو پول کریں۔ اس جواب کا آپ سے بل وصول نہیں کیا جاتا۔
- قسم: stringaccession
_number تیار کی جا رہی فائلنگ کا ایکسیشن نمبر۔
- قسم: string فارمیٹ: date-timeestimated
_ready _at فائلنگ کب تیار ہونے کی توقع ہے۔
- قسم: stringmessage
آگے کیا کرنا ہے اس کی انسانی پڑھنے کے قابل تفصیل۔
- قسم: string فارمیٹ: uuidrequest
_id اس درخواست کا شناخت کنندہ؛ سپورٹ سے رابطے کے وقت مفید۔
- قسم: stringresult
_url نتیجہ کے لیے پول کرنے کا URL۔
- enumstatusconst:processing
202 جواب پر ہمیشہ 'processing'۔
اقدار- processing
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}