# Получение всей финансовой отчётности

**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` ещё уже.

### Справочная информация о ценах

- Тарификация: фиксированная базовая стоимость успешного запроса.
- Справочная оценка запроса: USD 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 | Central Index Key (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. Полезно для запросов на определённый момент времени: возвращаются только данные, публично поданные к указанной дате. Строки без известной даты подачи исключаются. |
| `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 — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**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 в API submissions EDGAR. Сочетается с `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 в API submissions EDGAR. Сочетается с `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 в API submissions EDGAR. Сочетается с `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": "Разводнённое средневзвешенное число акций компании."
    }
  }
}
```