api-ninjas-com Income Statement API

openapi: 3.2.0
info:
  title: Ninjas Income Statement 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: Income Statement
  description: The Income Statement API returns income statement data for any public company listed in the United States, including revenue, gross profit, operating income, net income, earnings per share, and detailed expense breakdowns (cost of revenue, R&D, sales & marketing, G&A, stock-based compensation, and more). Figures are as reported by each company, in one consistent schema.
paths:
  /v1/incomestatement:
    get:
      tags:
      - Income Statement
      summary: Get income statement data for a specific company, period, and year
      description: Returns income 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 /incomestatementavailability.
      operationId: getIncomeStatement
      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/IncomeStatementResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
  /v1/incomestatementavailability:
    get:
      tags:
      - Income Statement
      summary: List which fiscal periods have income statement data for a company (premium)
      description: Returns the fiscal years and quarters for which income statement data is available for a company. Requires a premium subscription (Developer tier and above).
      operationId: getIncomeStatementAvailability
      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/IncomeStatementAvailabilityResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    IncomeStatementAvailabilityResponse:
      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 income statement 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
    IncomeStatementResponse:
      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
        income_statement:
          type: object
          description: Income statement figures in whole U.S. dollars.
          properties:
            total_revenue:
              type: integer
              example: 5873000000
            cost_of_revenue:
              type: integer
              example: 638000000
            gross_profit:
              type: integer
              example: 5235000000
            operating_income:
              type: integer
              example: 2109000000
            net_income:
              type: integer
              example: 1691000000
            earnings_per_share_basic:
              type: number
              example: 3.95
            earnings_per_share_diluted:
              type: number
              example: 3.94
            weighted_average_shares_basic:
              type: integer
              example: 428000000
            weighted_average_shares_diluted:
              type: integer
              example: 429000000
            research_and_development:
              type: integer
              example: 1082000000
            sales_and_marketing:
              type: integer
              example: 1626000000
            general_and_administrative:
              type: integer
              example: 377000000
            stock_based_compensation:
              type:
              - integer
              - 'null'
              example: 481000000
            depreciation_and_amortization:
              type: integer
              example: 209000000
            interest_expense:
              type: integer
              example: 68000000
            tax_provision:
              type: integer
              example: 410000000
        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'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api