api-ninjas-com Cash Flow API

openapi: 3.2.0
info:
  title: Ninjas Cash Flow API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Cash Flow
  description: The Cash Flow API returns cash flow statement data for any public company listed in the United States, including operating cash flow, investing cash flow, financing cash flow, free cash flow, capital expenditures, share repurchases, and dividends paid. Figures are as reported by each company, in one consistent schema.
paths:
  /v1/cashflow:
    get:
      tags:
      - Cash Flow
      summary: Get cash flow statement data for a specific company, period, and year
      description: Returns cash flow statement data from SEC 10-Q and 10-K filings for one company, fiscal period and year. Requires `ticker` or `cik`. For available periods use /cashflowavailability.
      operationId: getCashFlow
      parameters:
      - name: ticker
        in: query
        required: false
        description: Company ticker symbol (e.g., ADBE). Either ticker or cik must be provided. Share classes and preferred shares can be written in any common form, e.g. BRK.B, BRK-B, BRK/B or BRKB, and BAC.PRL or BAC-PL.
        schema:
          type: string
      - name: cik
        in: query
        required: false
        description: Company Central Index Key (e.g., 796343). Either ticker or cik must be provided.
        schema:
          type: string
      - name: period
        in: query
        required: false
        description: 'Fiscal period. Must be one of: q1, q2, q3, q4, or fy (full year). If set, year must also be set.'
        schema:
          type: string
          enum:
          - q1
          - q2
          - q3
          - q4
          - fy
      - name: year
        in: query
        required: false
        description: Fiscal year (e.g., 2025). Must be a valid year after 2000. Historical data before the previous year requires a premium subscription. If set, period must also be set.
        schema:
          type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CashFlowResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
  /v1/cashflowavailability:
    get:
      tags:
      - Cash Flow
      summary: List which fiscal periods have cash flow data for a company (premium)
      description: Returns the fiscal years and quarters for which cash flow data is available for a company. Requires a premium subscription (Developer tier and above).
      operationId: getCashFlowAvailability
      parameters:
      - name: ticker
        in: query
        required: false
        description: Company ticker symbol (e.g., ADBE). Either ticker or cik must be provided. Share classes and preferred shares can be written in any common form, e.g. BRK.B, BRK-B, BRK/B or BRKB, and BAC.PRL or BAC-PL.
        schema:
          type: string
      - name: cik
        in: query
        required: false
        description: Company Central Index Key (e.g., 796343). Either ticker or cik must be provided.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CashFlowAvailabilityResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    CashFlowResponse:
      type: object
      properties:
        company_info:
          type: object
          description: Company filing information including ticker, CIK, company name, fiscal year, and fiscal quarter.
          properties:
            ticker:
              type: string
              example: ADBE
            cik:
              type: string
              example: '796343'
            fiscal_year:
              type: integer
              example: 2025
            company_name:
              type: string
              example: ADOBE INC.
            fiscal_quarter:
              type: integer
              example: 2
        cash_flow:
          type: object
          description: Cash flow statement figures in whole U.S. dollars.
          properties:
            operating_cash_flow:
              type: integer
              example: 4673000000
            net_cash_investing:
              type: integer
              example: -762000000
            net_cash_financing:
              type: integer
              example: -6629000000
            free_cash_flow:
              type:
              - integer
              - 'null'
              example: 4590000000
            capital_expenditures:
              type: integer
              example: 73000000
            share_repurchases:
              type: integer
              example: 6750000000
            dividends_paid:
              type:
              - integer
              - 'null'
              example: null
        filing_info:
          type: object
          description: SEC filing metadata including filing type, filing date, and period end date.
          properties:
            filing_type:
              type: string
              example: 10-Q
            filing_date:
              type: string
              example: '2025-06-25'
            period_end_date:
              type: string
              example: '2025-05-30'
    CashFlowAvailabilityResponse:
      type: object
      properties:
        company_info:
          type: object
          description: 'Company identity: ticker, CIK, and company name.'
          properties:
            company_name:
              type: string
              example: ADOBE INC.
            cik:
              type: string
              example: '796343'
            ticker:
              type: string
              example: ADBE
        available_periods:
          type: array
          description: Fiscal years (newest first) and the periods within each that have cash flow data.
          items:
            type: object
            properties:
              year:
                type: integer
                example: 2024
              periods:
                type: array
                description: 'Available fiscal periods for the year: q1-q4 and fy (full year).'
                items:
                  type: string
                  enum:
                  - q1
                  - q2
                  - q3
                  - q4
                  - fy
                example:
                - q1
                - q2
                - q3
                - q4
                - fy
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api