# קבלת כל הדוחות הכספיים

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/financials`

**Tags:** Financial 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` צר עוד יותר.



### מראה תמחור

- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cik` | query | no | string | מפתח האינדקס המרכזי (CIK) של החברה. |
| `cursor` | query | no | string | סמן עימוד אטום מ-next_page_url של תגובה קודמת. כשמסופק, כל פרמטרי השאילתה האחרים מתעלמים: הסמן נושא את המסננים של הבקשה המקורית. התייחסו אליו כאטום; אל תיצרו או תשנו אותו. |
| `filing_date` | query | no | string, (date) | סינון לפי תאריך הגשה מדויק של SEC בפורמט YYYY-MM-DD. שורות ללא תאריך הגשה ידוע מוחרגות. |
| `filing_date_gt` | query | no | string, (date) | סינון לפי תאריך הגשה של SEC הגדול מתאריך בפורמט YYYY-MM-DD. שורות ללא תאריך הגשה ידוע מוחרגות. |
| `filing_date_gte` | query | no | string, (date) | סינון לפי תאריך הגשה של SEC הגדול או שווה לתאריך בפורמט YYYY-MM-DD. שורות ללא תאריך הגשה ידוע מוחרגות. |
| `filing_date_lt` | query | no | string, (date) | סינון לפי תאריך הגשה של SEC הקטן מתאריך בפורמט YYYY-MM-DD. שורות ללא תאריך הגשה ידוע מוחרגות. |
| `filing_date_lte` | query | no | string, (date) | סינון לפי תאריך הגשה של SEC הקטן או שווה לתאריך בפורמט YYYY-MM-DD. שימושי לשאילתות point-in-time: מחזיר רק נתונים שהוגשו בפומבי עד התאריך הנתון. שורות ללא תאריך הגשה ידוע מוחרגות. |
| `limit` | query | no | integer, (int32) | המספר המרבי של דוחות כספיים להחזרה. זהו סך כל העמודים, לא גודל עמוד: כל עמוד מכיל עד 10 רשומות, מקושרות ב-`next_page_url`. |
| `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | התקופה של הדוחות הכספיים. |
| `report_period` | query | no | string, (date) | סינון לפי תאריך תקופת דיווח מדויק בפורמט YYYY-MM-DD. |
| `report_period_gt` | query | no | string, (date) | סינון לפי תקופת דיווח גדולה מתאריך בפורמט YYYY-MM-DD. |
| `report_period_gte` | query | no | string, (date) | סינון לפי תקופת דיווח גדולה או שווה לתאריך בפורמט YYYY-MM-DD. |
| `report_period_lt` | query | no | string, (date) | סינון לפי תקופת דיווח קטנה מתאריך בפורמט YYYY-MM-DD. |
| `report_period_lte` | query | no | string, (date) | סינון לפי תקופת דיווח קטנה או שווה לתאריך בפורמט YYYY-MM-DD. |
| `ticker` | query | no | string | סמל הטיקר. חובה אם לא סופק cik. |

## Responses

### 200 — תגובת דוחות כספיים

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת Felo.

**application/json**

Schema: `ResponseE40Feb4D3D6B_FinancialsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsResponse`)

### 400 — לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

### 401 — נדרש מפתח API תקף של Felo.

### 402 — לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

### 403 — החשבון אינו מורשה לבצע את הפעולה הזו.

### 429 — הגעתם למגבלת בקשות או לתקרת הוצאה.

### 502 — השירות לא הצליח להשלים את הבקשה.

### 503 — שירות ה-API או החיוב אינו זמין באופן זמני.

### 504 — השירות פג בזמן הטיפול בבקשה.

### default — תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_BalanceSheet

`#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "סמל הטיקר."
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "תקופת הדיווח של המאזן."
    },
    "fiscal_period": {
      "type": "string",
      "description": "התקופה הפיסקלית של המאזן."
    },
    "period": {
      "type": "string",
      "enum": [
        "quarterly",
        "ttm",
        "annual"
      ],
      "description": "התקופה של המאזן."
    },
    "currency": {
      "type": "string",
      "description": "המטבע שבו מדווחים הנתונים הפיננסיים."
    },
    "accession_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "מספר ההצטרפות ב-SEC של ההגשה."
    },
    "form_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "טופס SEC שממנו נלקחה השורה הזו (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). הטופס המדויק כפי שהוגש, ולכן תיקונים שומרים על סיומת `/A`. Null כאשר `period` הוא `ttm`: חלון של שנים עשר חודשים מתגלגלים יכול לפרוש על פני כמה הגשות, ולכן איננו מייחסים אותו להגשה אחת. שורת `quarterly` יכולה לשאת `10-K` כאשר הרבעון הרביעי נגזר מההגשה השנתית."
    },
    "filing_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "כתובת URL להגשה ב-SEC."
    },
    "filing_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "היום הקלנדרי שבו SEC קיבלה את ההגשה, לפי שעון מזרח (אזור הזמן התפעולי של SEC). בן זוג קלנדרי ל-`filing_datetime`. Null כאשר לא מקושרת לשורה הגשת SEC מתוארכת."
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "חותמת זמן תת-יומית המתעדת מתי SEC קיבלה את ההגשה, לפי שעון מזרח. מקור: השדה `acceptanceDateTime` של SEC ב-EDGAR submissions API. עומד לצד `filing_date` (דיוק של יום קלנדרי לאותו אירוע)."
    },
    "total_assets": {
      "type": "number",
      "description": "סך הנכסים של החברה."
    },
    "current_assets": {
      "type": "number",
      "description": "הנכסים השוטפים של החברה."
    },
    "cash_and_equivalents": {
      "type": "number",
      "description": "המזומנים ושווי המזומנים של החברה."
    },
    "inventory": {
      "type": "number",
      "description": "המלאי של החברה."
    },
    "current_investments": {
      "type": "number",
      "description": "ההשקעות השוטפות של החברה."
    },
    "trade_and_non_trade_receivables": {
      "type": "number",
      "description": "חשבונות לגבייה סחריים ולא סחריים של החברה."
    },
    "non_current_assets": {
      "type": "number",
      "description": "הנכסים הלא שוטפים של החברה."
    },
    "property_plant_and_equipment": {
      "type": "number",
      "description": "הנדל\"ן, המתקנים והציוד של החברה."
    },
    "goodwill_and_intangible_assets": {
      "type": "number",
      "description": "המוניטין והנכסים הבלתי מוחשיים של החברה."
    },
    "investments": {
      "type": "number",
      "description": "ההשקעות של החברה."
    },
    "non_current_investments": {
      "type": "number",
      "description": "ההשקעות הלא שוטפות של החברה."
    },
    "outstanding_shares": {
      "type": "number",
      "description": "המניות בסחרור של החברה."
    },
    "tax_assets": {
      "type": "number",
      "description": "נכסי המס של החברה."
    },
    "total_liabilities": {
      "type": "number",
      "description": "סך ההתחייבויות של החברה."
    },
    "current_liabilities": {
      "type": "number",
      "description": "ההתחייבויות השוטפות של החברה."
    },
    "current_debt": {
      "type": "number",
      "description": "החוב השוטף של החברה."
    },
    "trade_and_non_trade_payables": {
      "type": "number",
      "description": "חשבונות לתשלום סחריים ולא סחריים של החברה."
    },
    "deferred_revenue": {
      "type": "number",
      "description": "ההכנסות הנדחות של החברה."
    },
    "deposit_liabilities": {
      "type": "number",
      "description": "התחייבויות הפיקדונות של החברה."
    },
    "non_current_liabilities": {
      "type": "number",
      "description": "ההתחייבויות הלא שוטפות של החברה."
    },
    "non_current_debt": {
      "type": "number",
      "description": "החוב הלא שוטף של החברה."
    },
    "tax_liabilities": {
      "type": "number",
      "description": "התחייבויות המס של החברה."
    },
    "shareholders_equity": {
      "type": "number",
      "description": "ההון העצמי של בעלי המניות של החברה."
    },
    "retained_earnings": {
      "type": "number",
      "description": "הרווחים העודפים של החברה."
    },
    "accumulated_other_comprehensive_income": {
      "type": "number",
      "description": "סך הרווח המקיף האחר המצטבר של החברה."
    },
    "total_debt": {
      "type": "number",
      "description": "סך החוב של החברה."
    }
  }
}
```

### ResponseE40Feb4D3D6B_CashFlowStatement

`#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "סמל הטיקר."
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "תקופת הדיווח של דוח תזרים המזומנים."
    },
    "fiscal_period": {
      "type": "string",
      "description": "התקופה הפיסקלית של דוח תזרים המזומנים."
    },
    "period": {
      "type": "string",
      "enum": [
        "quarterly",
        "ttm",
        "annual"
      ],
      "description": "התקופה של דוח תזרים המזומנים."
    },
    "currency": {
      "type": "string",
      "description": "המטבע שבו מדווחים הנתונים הפיננסיים."
    },
    "accession_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "מספר ההצטרפות ב-SEC של ההגשה."
    },
    "form_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "טופס SEC שממנו נלקחה השורה הזו (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). הטופס המדויק כפי שהוגש, ולכן תיקונים שומרים על סיומת `/A`. Null כאשר `period` הוא `ttm`: חלון של שנים עשר חודשים מתגלגלים יכול לפרוש על פני כמה הגשות, ולכן איננו מייחסים אותו להגשה אחת. שורת `quarterly` יכולה לשאת `10-K` כאשר הרבעון הרביעי נגזר מההגשה השנתית."
    },
    "filing_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "כתובת URL להגשה ב-SEC."
    },
    "filing_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "היום הקלנדרי שבו SEC קיבלה את ההגשה, לפי שעון מזרח (אזור הזמן התפעולי של SEC). בן זוג קלנדרי ל-`filing_datetime`. Null כאשר לא מקושרת לשורה הגשת SEC מתוארכת."
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "חותמת זמן תת-יומית המתעדת מתי SEC קיבלה את ההגשה, לפי שעון מזרח. מקור: השדה `acceptanceDateTime` של SEC ב-EDGAR submissions API. עומד לצד `filing_date` (דיוק של יום קלנדרי לאותו אירוע)."
    },
    "net_income": {
      "type": "number",
      "description": "הרווח הנקי של החברה."
    },
    "depreciation_and_amortization": {
      "type": "number",
      "description": "הפחת וההפחתות של החברה."
    },
    "share_based_compensation": {
      "type": "number",
      "description": "התגמול מבוסס המניות של החברה."
    },
    "net_cash_flow_from_operations": {
      "type": "number",
      "description": "תזרים המזומנים הנטו מפעילות של החברה."
    },
    "capital_expenditure": {
      "type": "number",
      "description": "הוצאות ההון של החברה."
    },
    "business_acquisitions_and_disposals": {
      "type": "number",
      "description": "רכישות ומימושים של עסקים של החברה."
    },
    "investment_acquisitions_and_disposals": {
      "type": "number",
      "description": "רכישות ומימושים של השקעות של החברה."
    },
    "net_cash_flow_from_investing": {
      "type": "number",
      "description": "תזרים המזומנים הנטו מהשקעות של החברה."
    },
    "issuance_or_repayment_of_debt_securities": {
      "type": "number",
      "description": "הנפקה או פירעון של ניירות חוב של החברה."
    },
    "issuance_or_purchase_of_equity_shares": {
      "type": "number",
      "description": "הנפקה או רכישה של מניות הון של החברה."
    },
    "dividends_and_other_cash_distributions": {
      "type": "number",
      "description": "הדיבידנדים וחלוקות המזומן האחרות של החברה."
    },
    "net_cash_flow_from_financing": {
      "type": "number",
      "description": "תזרים המזומנים הנטו ממימון של החברה."
    },
    "change_in_cash_and_equivalents": {
      "type": "number",
      "description": "השינוי במזומנים ושווי מזומנים של החברה."
    },
    "effect_of_exchange_rate_changes": {
      "type": "number",
      "description": "השפעת שינויי שערי החליפין של החברה."
    },
    "ending_cash_balance": {
      "type": "number",
      "description": "יתרת המזומנים בסוף התקופה של החברה."
    },
    "free_cash_flow": {
      "type": "number",
      "description": "תזרים המזומנים החופשי של החברה."
    }
  }
}
```

### ResponseE40Feb4D3D6B_FinancialsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsResponse`

```json
{
  "type": "object",
  "properties": {
    "financials": {
      "type": "object",
      "properties": {
        "income_statements": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_IncomeStatement"
          }
        },
        "balance_sheets": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet"
          }
        },
        "cash_flow_statements": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement"
          }
        }
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "כתובת URL מוחלטת של העמוד הבא של התוצאות. קיימת רק כאשר נותרו תוצאות נוספות; יש לבקש אותה כפי שהיא כדי להמשיך. כל עמוד מכיל עד 10 רשומות."
    }
  }
}
```

### ResponseE40Feb4D3D6B_IncomeStatement

`#/components/schemas/ResponseE40Feb4D3D6B_IncomeStatement`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "סמל הטיקר."
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "תקופת הדיווח של דוח רווח והפסד."
    },
    "fiscal_period": {
      "type": "string",
      "description": "התקופה הפיסקלית של דוח רווח והפסד."
    },
    "period": {
      "type": "string",
      "enum": [
        "quarterly",
        "ttm",
        "annual"
      ],
      "description": "התקופה של דוח רווח והפסד."
    },
    "currency": {
      "type": "string",
      "description": "המטבע שבו מדווחים הנתונים הפיננסיים."
    },
    "accession_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "מספר ההצטרפות ב-SEC של ההגשה."
    },
    "form_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "טופס SEC שממנו נלקחה השורה הזו (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). הטופס המדויק כפי שהוגש, ולכן תיקונים שומרים על סיומת `/A`. Null כאשר `period` הוא `ttm`: חלון של שנים עשר חודשים מתגלגלים יכול לפרוש על פני כמה הגשות, ולכן איננו מייחסים אותו להגשה אחת. שורת `quarterly` יכולה לשאת `10-K` כאשר הרבעון הרביעי נגזר מההגשה השנתית."
    },
    "filing_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "כתובת URL להגשה ב-SEC."
    },
    "filing_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "היום הקלנדרי שבו SEC קיבלה את ההגשה, לפי שעון מזרח (אזור הזמן התפעולי של SEC). בן זוג קלנדרי ל-`filing_datetime`. Null כאשר לא מקושרת לשורה הגשת SEC מתוארכת."
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "חותמת זמן תת-יומית המתעדת מתי SEC קיבלה את ההגשה, לפי שעון מזרח. מקור: השדה `acceptanceDateTime` של SEC ב-EDGAR submissions API. עומד לצד `filing_date` (דיוק של יום קלנדרי לאותו אירוע)."
    },
    "revenue": {
      "type": "number",
      "description": "סך ההכנסות של החברה."
    },
    "cost_of_revenue": {
      "type": "number",
      "description": "עלות ההכנסות של החברה."
    },
    "gross_profit": {
      "type": "number",
      "description": "הרווח הגולמי של החברה."
    },
    "operating_expense": {
      "type": "number",
      "description": "ההוצאות התפעוליות של החברה."
    },
    "selling_general_and_administrative_expenses": {
      "type": "number",
      "description": "הוצאות המכירה, ההנהלה והכלליות של החברה."
    },
    "research_and_development": {
      "type": "number",
      "description": "הוצאות המחקר והפיתוח של החברה."
    },
    "operating_income": {
      "type": "number",
      "description": "הרווח התפעולי של החברה."
    },
    "interest_expense": {
      "type": "number",
      "description": "הוצאות הריבית של החברה."
    },
    "ebit": {
      "type": "number",
      "description": "הרווח לפני ריבית ומסים של החברה."
    },
    "income_tax_expense": {
      "type": "number",
      "description": "הוצאות מס ההכנסה של החברה."
    },
    "net_income_discontinued_operations": {
      "type": "number",
      "description": "הרווח הנקי מפעילות מופסקת של החברה."
    },
    "net_income_non_controlling_interests": {
      "type": "number",
      "description": "הרווח הנקי מזכויות שאינן מקנות שליטה של החברה."
    },
    "net_income": {
      "type": "number",
      "description": "הרווח הנקי של החברה."
    },
    "net_income_common_stock": {
      "type": "number",
      "description": "הרווח הנקי הזמין לבעלי מניות רגילות של החברה."
    },
    "preferred_dividends_impact": {
      "type": "number",
      "description": "ההשפעה של דיבידנדים מועדפים על הרווח הנקי של החברה."
    },
    "consolidated_income": {
      "type": "number",
      "description": "ההכנסה המאוחדת של החברה."
    },
    "earnings_per_share": {
      "type": "number",
      "description": "הרווח למניה של החברה."
    },
    "earnings_per_share_diluted": {
      "type": "number",
      "description": "הרווח המדולל למניה של החברה."
    },
    "dividends_per_common_share": {
      "type": "number",
      "description": "הדיבידנדים לכל מניה רגילה של החברה."
    },
    "weighted_average_shares": {
      "type": "number",
      "description": "ממוצע משוקלל של המניות של החברה."
    },
    "weighted_average_shares_diluted": {
      "type": "number",
      "description": "ממוצע משוקלל מדולל של המניות של החברה."
    }
  }
}
```
