# GET /v3/companies/{cik_or_ticker}/cash-flow

Get a company's cash flow statement by period.

Periods are fiscal years, quarters, or trailing twelve months. You get standardized fields in a fixed order, as line_items {concept, label, unit, accuracy, values\[\]}. Each value has its period, status, source filing (accession_number, form_type, filing_date) and, when derived (Q4 = FY - 9M, ttm = the four quarters), its formula. A blank is never a zero. A line with no value in the periods is left out. accuracy gives the field's measured precision and coverage.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Financial data (XBRL)](https://www.secblast.com/docs/reference#financial-data-xbrl)

## Try it

Send this route from the page, signed in with your key, or from the [console](https://www.secblast.com/console).

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik_or_ticker` | path | string | yes |   | The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK. |
| `period` | query | string | no | `annual` | annual, quarterly (reported or derived quarters) or ttm (trailing twelve months at each quarter end). One of: `annual`, `quarterly`, `ttm`. |
| `limit` | query | integer | no | `8` | Periods, newest first, 1 to 200. |
| `as_of` | query | string | no |   | Point in time: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [SimpleStatement](https://www.secblast.com/docs/reference/schemas#schema-simplestatement) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [SimpleStatement](https://www.secblast.com/docs/reference/schemas#schema-simplestatement) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `as_of` | string \| null | yes |   |
| `basis` | string | yes | How the accuracy numbers were measured. |
| `cik` | string | yes |   |
| `excluded` | [Excluded](https://www.secblast.com/docs/reference/schemas#schema-excluded) | yes |   |
| `excluded_total` | integer | yes |   |
| `has_more` | boolean | yes | True when periods older than the oldest one returned exist. |
| `limit` | integer | yes |   |
| `line_items` | array of [SimpleStatementLine](https://www.secblast.com/docs/reference/schemas#schema-simplestatementline) | yes | The lines in the statement's fixed order. A line with no value in any period is left out. |
| `map` | object | yes |   |
| `period` | string | yes | One of: `annual`, `quarterly`, `ttm`. |
| `statement` | string | yes | One of: `balance_sheet`, `income_statement`, `cash_flow`. |

## Example request

```python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/cash-flow",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
```

## Example answer

```python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/cash-flow",
    params={"period": "annual", "limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
```

```json
{
  "as_of": null,
  "basis": "per field, its set: holdout-5 (the core 15), holdout-6 (the full template's further fields) or holdout-7 (sga, selling_marketing, general_administrative under map full-1.1.0), 300 company-year cells each never used to write the rules, values checked against SEC's R pages; precision = correct / serve…(truncated)",
  "cik": "0000320193",
  "excluded": [],
  "excluded_total": 0,
  "has_more": true,
  "limit": 2,
  "line_items": [
    {
      "accuracy": {
        "correct": 297,
        "coverage_pct": 99.3,
        "precision_pct": 99.66,
        "served": 298,
        "set": "holdout-5"
      },
      "concept": "operating_cash_flow",
      "label": "Net cash from operating activities",
      "unit": "iso4217:USD",
      "values": [
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2026,
          "form_type": "10-K",
          "period_end": "2026-09-26",
          "period_start": "2025-09-28",
          "source": "reported",
          "status": "ok",
          "value": "145097000000"
        },
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2025,
          "form_type": "10-K",
          "period_end": "2025-09-27",
          "period_start": "2024-09-29",
          "source": "reported",
          "status": "ok",
          "value": "111482000000"
        }
      ]
    },
    {
      "accuracy": {
        "correct": 217,
        "coverage_pct": 73.3,
        "precision_pct": 98.64,
        "served": 220,
        "set": "holdout-6"
      },
      "concept": "depreciation_amortization",
      "label": "Depreciation and amortization",
      "unit": "iso4217:USD",
      "values": [
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2026,
          "form_type": "10-K",
          "period_end": "2026-09-26",
          "period_start": "2025-09-28",
          "source": "reported",
          "status": "ok",
          "value": "13423000000"
        },
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2025,
          "form_type": "10-K",
          "period_end": "2025-09-27",
          "period_start": "2024-09-29",
          "source": "reported",
          "status": "ok",
          "value": "11698000000"
        }
      ]
    }
  ],
  "map": {
    "fingerprint": "ade632e382bf0a76c5b99dc3c7e693d0cb41378812323adf61b635f865680895",
    "version": "full-1.1.0"
  },
  "period": "annual",
  "statement": "cash_flow",
  "resolved": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "ticker_file_date": "2026-11-18"
  }
}
```

## More in Financial data (XBRL)

Previous: [`GET /v3/companies/{cik_or_ticker}/balance-sheet`](https://www.secblast.com/docs/reference/get-companies-cik-or-ticker-balance-sheet) · Next: [`GET /v3/companies/{cik_or_ticker}/income-statement`](https://www.secblast.com/docs/reference/get-companies-cik-or-ticker-income-statement)
