> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockinsights.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cash Flow Statement

> Retrieve an as-reported cash flow statement for a US issuer by SEC CIK, period end date, and reporting type. Resolves across 10-Q, 10-K, and 20-F filings (including amendments), preferring the original filing that first reported the period.



## OpenAPI

````yaml openapi-us get /api/us/v0/financial-statements/cash-flow
openapi: 3.0.0
info:
  title: stockinsights.ai APIs
  description: All the APIs of stockinsights.ai
  version: 1.0.0
servers:
  - url: https://stockinsights-ai-us-main-f5fd25a.zuplo.app
security:
  - bearerAuth: []
paths:
  /api/us/v0/financial-statements/cash-flow:
    get:
      tags:
        - Financial Statements
      summary: Cash Flow Statement
      description: >-
        Retrieve an as-reported cash flow statement for a US issuer by SEC CIK,
        period end date, and reporting type. Resolves across 10-Q, 10-K, and
        20-F filings (including amendments), preferring the original filing that
        first reported the period.
      operationId: getUSCashFlowStatement
      parameters:
        - name: cik
          in: query
          required: true
          description: SEC Central Index Key for the issuer, zero-padded to 10 digits.
          schema:
            type: string
            pattern: ^[0-9]{10}$
            example: '0000320193'
        - name: period_end_date
          in: query
          required: true
          description: >-
            Period end date in YYYY-MM-DD format. Must match the report_end_date
            of a column in the filing's XBRL data (e.g. a quarter end for 10-Q
            or fiscal year end for 10-K / 20-F).
          schema:
            type: string
            format: date
            example: '2025-09-27'
        - name: reporting_type
          in: query
          required: true
          description: >-
            Reporting period length. Use `quarterly` for 10-Q three-month
            columns, `half_yearly` / `nine_months` for cumulative interim
            columns, and `annual` for 10-K / 20-F full-year columns.
          schema:
            type: string
            enum:
              - quarterly
              - half_yearly
              - nine_months
              - annual
            example: quarterly
      responses:
        '200':
          description: Successful response with US as-reported XBRL statement data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/USReportedStatementResponse'
              example:
                status: success
                data:
                  company_id: '0000320193'
                  cik: '0000320193'
                  statement_type: cash_flow
                  reporting_type: quarterly
                  fiscal_year: 2025
                  fiscal_quarter: Q3
                  period_end_date: '2025-09-27'
                  currency: USD
                  ticker: AAPL
                  accession_number: 0000320193-25-000079
                  filing_url: >-
                    https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm
                  metrics:
                    net_cash_provided_by_used_in_operating_activities: 31100000000
                    payments_to_acquire_property_plant_and_equipment: 3280000000
                    repayments_of_debt: 2500000000
        '400':
          description: >-
            Invalid request. cik must be a 10-digit string, period_end_date must
            be YYYY-MM-DD, and reporting_type must be one of: quarterly,
            half_yearly, nine_months, annual.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            No filing or statement rows found for the given cik and
            period_end_date.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    USReportedStatementResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
        data:
          $ref: '#/components/schemas/USReportedStatementData'
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              status:
                type: string
                description: Error status
              title:
                type: string
                description: Error description
    USReportedStatementData:
      type: object
      properties:
        company_id:
          type: string
          description: Internal company identifier for the filing.
        cik:
          type: string
          description: SEC Central Index Key, zero-padded to 10 digits.
          example: '0000320193'
        statement_type:
          type: string
          enum:
            - income_statement
            - balance_sheet
            - cash_flow
        reporting_type:
          type: string
          enum:
            - quarterly
            - half_yearly
            - nine_months
            - annual
            - instant
        fiscal_year:
          type: integer
          nullable: true
        fiscal_quarter:
          type: string
          nullable: true
          enum:
            - Q1
            - Q2
            - Q3
            - Q4
        period_end_date:
          type: string
          format: date
        currency:
          type: string
          nullable: true
          description: Currency code inferred from XBRL units, when available.
        ticker:
          type: string
          nullable: true
        accession_number:
          type: string
        filing_url:
          type: string
          format: uri
        metrics:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/USReportedStatementMetric'
          description: >-
            As-reported statement metrics keyed by normalized SEC concept local
            names.
    USReportedStatementMetric:
      oneOf:
        - type: number
        - type: object
          required:
            - components
          properties:
            total:
              type: number
              description: >-
                Reported total for the metric. Present only when the filing
                tagged a parent concept alongside its component breakdown.
            components:
              type: object
              additionalProperties:
                type: number
              description: Component breakdown keyed by normalized SEC concept local names.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````