# Cash Flow Statements

> Cash Flow Statements is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-14).

Retrieves SEC-sourced cash flow statements for a given ticker symbol or CIK, supporting annual, quarterly, and trailing-twelve-month periods with date filtering and pagination.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/financial/financials/cash-flow-statements?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-cash-flow-statements-e231eb02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_veI8dif14pm3wHzz837xU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-cash-flow-statements-e231eb02
```

Example prompt: Pull the last 4 quarterly cash flow statements for AAPL from AIsa — I want to see net income, free cash flow, and operating cash flow for each period.

## When to prefer this

Choose this endpoint when you need structured, SEC-sourced cash flow data for US-listed companies with flexible period types (annual, quarterly, TTM) and precise date-range filtering. Prefer it over generic financial data providers when you need point-in-time accuracy (data as filed by a specific date), direct links to SEC filings, or pagination over long historical series. It is pay-per-call at $0.02 USDC, making it cost-effective for targeted lookups rather than bulk data warehouse needs.

## Known failure modes

- Missing required 'period' parameter returns a 400 validation error
- Neither ticker nor CIK provided results in a 400 error requiring at least one identifier
- Invalid ticker symbol returns an empty array or 404
- Filing date filters excluding rows without known filing dates may silently omit records
- Cursor from a different query context may return unexpected results or an error
- Rate limit or payment failure returns a 402 or 429 error

## How this service works

Get cash flow statements for a ticker.

<!-- aisa-pricing:start -->
Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns an array of cash flow statement objects, each including ticker, period type, fiscal period, report period, filing date, SEC form type, filing URL, currency, net income, free cash flow, and detailed line items for operating, investing, and financing activities. Paginated via next_page_url when more than 10 records exist.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "period"
 ],
 "properties": {
  "cik": {
   "type": "string",
   "description": "The Central Index Key (CIK) of the company."
  },
  "isin": {
   "type": "string",
   "description": "The ISIN (International Securities Identification Number) of a non-US listing. An alternative to `ticker` and `exchange`."
  },
  "limit": {
   "type": "integer",
   "format": "int32",
   "description": "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`."
  },
  "cursor": {
   "type": "string",
   "description": "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."
  },
  "period": {
   "enum": [
    "annual",
    "quarterly",
    "ttm"
   ],
   "type": "string",
   "description": "The time period of the cash flow statements."
  },
  "ticker": {
   "type": "string",
   "description": "The ticker symbol. Required if cik or isin is not provided."
  },
  "exchange": {
   "enum": [
    "LSE"
   ],
   "type": "string",
   "description": "The exchange the ticker is listed on. Omit for US listings. Use `LSE` for the London Stock Exchange; any ticker of the company, including a second share class, returns the company's statements."
  },
  "filing_date": {
   "type": "string",
   "format": "date",
   "description": "Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "report_period": {
   "type": "string",
   "format": "date",
   "description": "Filter by exact report period date in YYYY-MM-DD format."
  },
  "filing_date_gt": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "filing_date_lt": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "filing_date_gte": {
   "type": "string",
   "format": "date",
   "description": "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_lte": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC f
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "next_page_url": {
   "type": "string",
   "description": "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."
  },
  "cash_flow_statements": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "period": {
      "enum": [
       "quarterly",
       "ttm",
       "annual"
      ],
      "type": "string",
      "description": "The time period of the cash flow statement."
     },
     "ticker": {
      "type": "string",
      "description": "The ticker symbol."
     },
     "currency": {
      "type": "string",
      "description": "The currency in which the financial data is reported."
     },
     "form_type": {
      "type": [
       "string",
       "null"
      ],
      "description": "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."
     },
     "filing_url": {
      "type": [
       "string",
       "null"
      ],
      "format": "uri",
      "description": "URL to the SEC filing."
     },
     "net_income": {
      "type": "number",
      "description": "The net income of the company."
     },
     "filing_date": {
      "type": [
       "string",
       "null"
      ],
      "format": "date",
      "description": "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."
     },
     "fiscal_period": {
      "type": "string",
      "description": "The fiscal period of the cash flow statement."
     },
     "report_period": {
      "type": "string",
      "format": "date",
      "description": "The reporting period of the cash flow statement."
     },
     "free_cash_flow": {
      "type": "number",
      "description": "The free cash flow of the company."
     },
     "filing_datetime": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time",
      "description": "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_d
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-cash-flow-statements-e231eb02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)