NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Cash Flow API

The Cash Flow API returns cash flow statement data for any public company listed in the United States, including operating cash flow, investing cash flow, financing cash flow, free cash flow, capital expenditures, share repurchases, and dividends paid. All data is sourced from official SEC filings (10-Q, 10-K).

Need the full picture in one call? See the Earnings API. For other statements, see the Income Statement API and Balance Sheet API.

(4.2)

From 5,719 users

3,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
275ms298ms327ms695ms1210ms

Didn't find what you were looking for? Suggest an improvement

/v1/cashflow GET

https://api.api-ninjas.com/v1/cashflow

Returns cash flow statement data for a specific company, period, and year. You can identify the company using either a ticker symbol or CIK (Central Index Key).

Q1, Q2, and Q3 figures are sourced from 10-Q filings. Q4 figures are derived from the 10-K filing by subtracting the Q1, Q2, and Q3 cash flow figures from the 10-K full-year totals.

Parameters

If you do not specify a year or period, the API will return the most recent cash flow statement.

  • ticker  optional

    Company ticker symbol (e.g., ADBE). Either ticker or cik must be provided.

  • cik  optional

    Company Central Index Key (e.g., 796343). Either ticker or cik must be provided.

  • period  optional

    Fiscal period. Must be one of: q1, q2, q3, q4, or fy (full year). If set, year must also be set.

  • year  optional

    Fiscal year. E.g. 2025. Must be a valid year after 2000. For historical data before 2025, you must have a premium subscription. If set, period must also be set.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • company_info

    Company filing information including ticker, CIK, company name, fiscal year, and fiscal quarter.

  • cash_flow

    Cash flow statement figures: operating_cash_flow, net_cash_investing, net_cash_financing, free_cash_flow, capital_expenditures, share_repurchases, and dividends_paid.

  • filing_info

    SEC filing metadata including filing type, filing date, and period end date.

Sample Request Live Demo!

ticker
year 
period
cik

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/cashflow?ticker=ADBE&year=2025&period=q2

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    company_info:{
      ticker:"ADBE",
      cik:"796343",
      fiscal_year:2025,
      company_name:"ADOBE INC.",
      fiscal_quarter:2
    },
    cash_flow:{
      share_repurchases:6750000000,
      operating_cash_flow:4673000000,
      net_cash_investing:-762000000,
      net_cash_financing:-6629000000,
      free_cash_flow:4590000000,
      capital_expenditures:73000000,
      dividends_paid:null
    },
    filing_info:{
      filing_type:"10-Q",
      filing_date:"2025-06-25",
      period_end_date:"2025-05-30"
    }
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cashflow?ticker=ADBE&year=2025&period=q2" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Cash Flow API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Set the period parameter to q1, q2, q3, q4, or fy along with a year (both must be set together); Q1-Q3 come directly from 10-Q filings while Q4 is derived from the 10-K by subtracting the first three quarters from full-year totals. If you omit both, the API returns the most recent statement, and historical years require a premium subscription.
  • Yes. You can identify a company with either the ticker parameter (e.g. ADBE) or the cik parameter (e.g. 796343) Central Index Key, but at least one must be provided. For lookups based on official SEC identifiers, the SEC API is also useful.
  • The cash_flow object returns operating_cash_flow, net_cash_investing, net_cash_financing, free_cash_flow, capital_expenditures, share_repurchases, and dividends_paid, while the filing_info object includes the filing type, filing date, and period end date. To pair these with profitability and balance figures, see the Income Statement API and Balance Sheet API.
  • All figures are sourced directly from official SEC filings (10-Q and 10-K) for any public company listed in the United States. For a broader view of a company's reported results, see the Earnings API.