---
title: "Company cash flow statements"
method: GET
path: "/v1/companies/cash-flow-statements"
---

# Company cash flow statements

`GET /v1/companies/cash-flow-statements`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/companies/cash-flow-statements`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use this route to review operating, investing, and financing cash-flow history for one issuer. Choose annual or quarterly cadence before comparing periods, because cash-flow rows describe a duration rather than a point-in-time balance. Values are normalized from supported SEC XBRL filings and retain units, periods, and provenance; free-cash-flow fields are derived from those filings, not a forecast. See [statements reference](/api-reference/statements) and [freshness and source evidence](/freshness-and-trust).

## Query parameters

- `ticker` string
- `cik` string
- `period` 'annual' | 'quarterly'
- `fy` integer
- `fy_from` integer
- `fy_to` integer
- `limit` integer
- `view` 'compact'

## Response `200`

Successful response. The default response is Statement; view=compact returns CompactStatement.

- union
  - Statement
    - `object` 'statement', required
    - `id` string, required
    - `createdAt` string, required
    - `livemode` boolean, required
    - `entityId` string, required
    - `ticker` string, nullable, required
    - `companyName` string, required
    - `statementKey` string, required
    - `title` string, required
    - `period` 'annual' | 'quarterly', required
    - `periods` object[], required
      - `periodEnd` string
      - `filedAt` string, nullable
      - `form` string, nullable
      - `fy` number, nullable
      - `fp` string, nullable
    - `rows` object[], required
      - `key` string
      - `tag` string
      - `taxonomy` string
      - `label` string
      - `unit` string, nullable
      - `values` object[]
    - `provenance` ResponseMetadata, required
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
    - `completeness` object
    - `freshness` FreshnessMetadata: Freshness of the record. For SEC filings, freshness measures the delay between SEC acceptance (`sourcePublishedAt`) and when the record became available in the API — not the age of the document. Statuses: `current` (recently published and available promptly), `archival` (an immutable historical document held in full; its availability delay is not a freshness signal), `degraded`/`stale` (a recently published filing that became available later than the freshness thresholds allow), `fresh` (continuously refreshed datasets recently observed at source), `unknown` (no timestamps). An old immutable filing is never `stale` simply because it was published long ago. `lagMs` is the publish-to-availability delay in milliseconds.
      - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
      - `asOf` string, required
      - `sourcePublishedAt` string, nullable
      - `lagMs` integer, nullable
    - `materialization` MaterializationMetadata
      - `parserVersion` string, required
      - `materializationVersion` string, required
    - `validation` ValidationStatus
      - `status` 'validated' | 'unvalidated' | 'degraded', required
      - `confidence` 'high' | 'medium' | 'low', nullable
      - `validatedAt` string, nullable
      - `validationPipeline` string, nullable
      - `exceptions` string[]
    - `traceparent` string
  - CompactStatement
    - `ticker` string, nullable, required
    - `statementKey` string, nullable, required
    - `period` 'annual' | 'quarterly', nullable, required
    - `periods` object[], required
      - `periodEnd` string, required
      - `filedAt` string, nullable, required
      - `form` string, nullable, required
      - `fy` number, nullable, required
      - `fp` string, nullable, required
    - `rows` object[], required
      - `key` string, nullable, required
      - `label` string, nullable
      - `unit` string, nullable, required
      - `values` number[], required
      - `discrete` number[]
    - `requestId` string
    - `traceparent` string, nullable

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)