Cash Flow Statements
Retrieve SEC cash flow statement rows by filing period. Filter by CIK, tickers, filing and period dates, fiscal year and quarter, timeframe, and pagination.
Use Case: Pull operating, investing, and financing cash flows for a company across quarterly or annual filings for fundamental analysis.
Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Query Parameters
Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
Comma-separated CIKs (maps to cik.any_of)
CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
CIK greater than or equal (inclusive)
CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
Exact fiscal period-end date filter. Use it to return statements for one reporting period.
Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
Fiscal period-end start filter. Returns records on or after this date.
Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
Fiscal period-end end filter. Returns records on or before this date.
Exact filing date filter. Use it to return filings submitted on one specific date.
Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
Filing-date start filter. Returns records on or after this date.
Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
Filing-date end filter. Returns records on or before this date.
Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
Ticker all-of filter. Return records that include all listed tickers.
Ticker any-of filter. Return records that include at least one listed ticker.
Exact fiscal year filter. Use it to return statements for one reporting year.
Fiscal year greater than (exclusive)
Fiscal year greater than or equal (inclusive)
Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
Fiscal year less than or equal (inclusive)
Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
Fiscal quarter greater than (exclusive)
Fiscal quarter greater than or equal (inclusive)
Fiscal quarter less than (exclusive)
Fiscal quarter less than or equal (inclusive)
Reporting timeframe (e.g. quarterly, annual)
Timeframe any-of filter. Return records that match at least one listed timeframe.
Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
Timeframe greater than or equal (inclusive)
Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
Timeframe less than or equal (inclusive)
Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
Max ticker any-of filter. Return records matching at least one listed maxTicker value.
Max ticker greater than (exclusive)
Max ticker greater than or equal (inclusive)
Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
Max ticker less than or equal (inclusive)
Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
Min ticker any-of filter. Return records matching at least one listed minTicker value.
Min ticker greater than (exclusive)
Min ticker greater than or equal (inclusive)
Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
Min ticker less than or equal (inclusive)
Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
x >= 1A comma-separated list of sort columns. For each column, append .asc or .desc to specify direction. Defaults to period_end.asc when not specified.
Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
Response
Successful response with one or more SEC cash flow rows, status, request id, and optional nextUrl for pagination.
Paginated SEC cash flow statements (results, status, requestId, nextUrl).
Cash flow statement rows for the requested filters. Use these to analyze operating, investing, and financing cash flows.
Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.
Provider request identifier. Include this when reporting data issues to support.
URL for the next page when more results exist