Felo API PlatformFelo API Platform
All Financial Data endpoints
v0.2.0-beta
OpenAPI 3.1.0

Get income statements

Server:https://openapi.felo.ai
Client Libraries

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Get income statements

​

Income statements for one company, about 32 fields per period: revenue, cost_of_revenue, gross_profit, operating_expense, selling_general_and_administrative_expenses, research_and_development, operating_income, interest_expense, ebit, income_tax_expense, net_income, net_income_common_stock and the per-share lines, each stamped with report_period, fiscal_period, currency, filing_date and filing_url. period is a selector (annual, quarterly or ttm). Use it for the revenue-to-earnings walk. For all three statements at once use get_financial_financials.

Pricing reference

  • Metering: Fixed successful-request cost basis.
  • Reference request estimate: USD 0.02.
  • Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

Query Parameters
  • limit
    Type: string
  • period
    Type: string
  • ticker
    Type: string
Responses
  • 200
    Type: object · ResponseE40Feb4D3D6B_IncomeStatementResponse

    Income statements response

    • income_statements
      Type: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
      • accession_number
        Type: string | null

        The SEC accession number of the filing.

      • consolidated_income
        Type: number

        The consolidated income of the company.

      • cost_of_revenue
        Type: number

        The cost of revenue of the company.

      • currency
        Type: string

        The currency in which the financial data is reported.

      • dividends_per_common_share
        Type: number

        The dividends per common share of the company.

      • earnings_per_share
        Type: number

        The earnings per share of the company.

      • earnings_per_share_diluted
        Type: number

        The diluted earnings per share of the company.

      • ebit
        Type: number

        The earnings before interest and taxes of the company.

      • filing_date
        Type: string | null Format: date

        Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to filing_datetime. Null when no dated SEC filing is linked to the row.

      • filing_datetime
        Type: string | null Format: date-time

        Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's acceptanceDateTime field on the EDGAR submissions API. Pairs with filing_date (calendar-day precision of the same event).

      • filing_url
        Type: string | null Format: uri

        URL to the SEC filing.

      • fiscal_period
        Type: string

        The fiscal period of the income statement.

      • form_type
        Type: string | null

        The SEC form this row was sourced from (10-K, 10-Q/A, 20-F, S-1, ...). The exact form as filed, so amendments keep their /A suffix. Null when period is ttm: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A quarterly row can carry 10-K when the fourth quarter is derived from the fiscal-year filing.

      • gross_profit
        Type: number

        The gross profit of the company.

      • income_tax_expense
        Type: number

        The income tax expenses of the company.

      • interest_expense
        Type: number

        The interest expenses of the company.

      • net_income
        Type: number

        The net income of the company.

      • net_income_common_stock
        Type: number

        The net income available to common stockholders of the company.

      • net_income_discontinued_operations
        Type: number

        The net income from discontinued operations of the company.

      • net_income_non_controlling_interests
        Type: number

        The net income from non-controlling interests of the company.

      • operating_expense
        Type: number

        The operating expenses of the company.

      • operating_income
        Type: number

        The operating income of the company.

      • period
        Type: string enum

        The time period of the income statement.

        values
        • quarterly
        • ttm
        • annual
      • preferred_dividends_impact
        Type: number

        The impact of preferred dividends on the net income of the company.

      • report_period
        Type: string Format: date

        The reporting period of the income statement.

      • research_and_development
        Type: number

        The research and development expenses of the company.

      • revenue
        Type: number

        The total revenue of the company.

      • selling_general_and_administrative_expenses
        Type: number

        The selling, general, and administrative expenses of the company.

      • ticker
        Type: string

        The ticker symbol.

      • weighted_average_shares
        Type: number

        The weighted average shares of the company.

      • weighted_average_shares_diluted
        Type: number

        The diluted weighted average shares of the company.

    • next_page_url
      Type: string

      Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    Error response; upstream passthrough responses may use provider formats

    application/json
Request Example for get/v1/beta/financial/financials/income-statements
curl https://openapi.felo.ai/v1/beta/financial/financials/income-statements \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "income_statements": [
    {
      "ticker": "string",
      "report_period": "2026-10-23",
      "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
    }
  ],
  "next_page_url": "string"
}
Get income statements

Need help?