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

Get cash flow statements

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

Financial Data

​

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

Get cash flow statements

​

Cash flow statements for one company, about 27 fields per period: net_cash_flow_from_operations, net_cash_flow_from_investing, net_cash_flow_from_financing, capital_expenditure, depreciation_and_amortization, share_based_compensation, issuance_or_repayment_of_debt_securities, issuance_or_purchase_of_equity_shares and dividends_and_other_cash_distributions, stamped with report_period, fiscal_period and currency. period is required. Use it to see cash generation rather than accounting earnings. Free cash flow yield and similar derived figures live in get_financial_financial_metrics.

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
  • cik
    Type: string

    The Central Index Key (CIK) of the company.

  • cursor
    Type: string

    Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

  • filing_date
    Type: string Format: date

    Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.

  • filing_date_gt
    Type: string Format: date

    Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

  • filing_date_gte
    Type: string Format: date

    Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.

  • filing_date_lt
    Type: string Format: date

    Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

  • filing_date_lte
    Type: string Format: date

    Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.

  • limit
    Type: integer Format: int32

    The maximum number of cash flow statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

  • period
    Type: string enum
    required

    The time period of the cash flow statements.

    values
    • annual
    • quarterly
    • ttm
  • report_period
    Type: string Format: date

    Filter by exact report period date in YYYY-MM-DD format.

  • report_period_gt
    Type: string Format: date

    Filter by report period greater than date in YYYY-MM-DD format.

  • report_period_gte
    Type: string Format: date

    Filter by report period greater than or equal to date in YYYY-MM-DD format.

  • report_period_lt
    Type: string Format: date

    Filter by report period less than date in YYYY-MM-DD format.

  • report_period_lte
    Type: string Format: date

    Filter by report period less than or equal to date in YYYY-MM-DD format.

  • ticker
    Type: string

    The ticker symbol. Required if cik is not provided.

Responses
  • 200
    Type: object · ResponseE40Feb4D3D6B_CashFlowStatementResponse

    Cash flow statements response

    • cash_flow_statements
      Type: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
      • accession_number
        Type: string | null

        The SEC accession number of the filing.

      • business_acquisitions_and_disposals
        Type: number

        The business acquisitions and disposals of the company.

      • capital_expenditure
        Type: number

        The capital expenditure of the company.

      • change_in_cash_and_equivalents
        Type: number

        The change in cash and equivalents of the company.

      • currency
        Type: string

        The currency in which the financial data is reported.

      • depreciation_and_amortization
        Type: number

        The depreciation and amortization of the company.

      • dividends_and_other_cash_distributions
        Type: number

        The dividends and other cash distributions of the company.

      • effect_of_exchange_rate_changes
        Type: number

        The effect of exchange rate changes of the company.

      • ending_cash_balance
        Type: number

        The ending cash balance 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 cash flow 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.

      • free_cash_flow
        Type: number

        The free cash flow of the company.

      • investment_acquisitions_and_disposals
        Type: number

        The investment acquisitions and disposals of the company.

      • issuance_or_purchase_of_equity_shares
        Type: number

        The issuance or purchase of equity shares of the company.

      • issuance_or_repayment_of_debt_securities
        Type: number

        The issuance or repayment of debt securities of the company.

      • net_cash_flow_from_financing
        Type: number

        The net cash flow from financing of the company.

      • net_cash_flow_from_investing
        Type: number

        The net cash flow from investing of the company.

      • net_cash_flow_from_operations
        Type: number

        The net cash flow from operations of the company.

      • net_income
        Type: number

        The net income of the company.

      • period
        Type: string enum

        The time period of the cash flow statement.

        values
        • quarterly
        • ttm
        • annual
      • report_period
        Type: string Format: date

        The reporting period of the cash flow statement.

      • share_based_compensation
        Type: number

        The share-based compensation of the company.

      • ticker
        Type: string

        The ticker symbol.

    • 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/cash-flow-statements
curl 'https://openapi.felo.ai/v1/beta/financial/financials/cash-flow-statements?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "cash_flow_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,
      "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"
}
Get cash flow statements

Need help?