api-ninjas-com Balance Sheet API

openapi: 3.2.0
info:
  title: Ninjas Balance Sheet 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: Balance Sheet
  description: The Balance Sheet API returns balance sheet data for any public company listed in the United States, including total assets, current and long-term liabilities, stockholders equity, cash and equivalents, total debt, goodwill, intangible assets, accounts receivable and payable, property plant and equipment, working capital, and retained earnings. Figures are as reported by each company, in one consistent schema.
paths:
  /v1/balancesheet:
    get:
      tags:
      - Balance Sheet
      summary: Get balance sheet data for a specific company, period, and year
      description: Returns balance sheet data from SEC 10-Q and 10-K filings for one company, fiscal period and year. Requires `ticker` or `cik`. For which periods exist use /balancesheetavailability.
      operationId: getBalanceSheet
      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/BalanceSheetResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
  /v1/balancesheetavailability:
    get:
      tags:
      - Balance Sheet
      summary: List which fiscal periods have balance sheet data for a company (premium)
      description: Returns the fiscal years and quarters for which balance sheet data is available for a company. Requires a premium subscription (Developer tier and above).
      operationId: getBalanceSheetAvailability
      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/BalanceSheetAvailabilityResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    BalanceSheetAvailabilityResponse:
      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 balance sheet 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
    BalanceSheetResponse:
      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
        balance_sheet:
          type: object
          description: Balance sheet figures in whole U.S. dollars.
          properties:
            total_assets:
              type: integer
              example: 28107000000
            current_assets:
              type: integer
              example: 8978000000
            cash_and_equivalents:
              type: integer
              example: 4931000000
            accounts_receivable:
              type: integer
              example: 1735000000
            inventory:
              type:
              - integer
              - 'null'
              example: null
            property_plant_equipment:
              type: integer
              example: 1890000000
            intangible_assets:
              type: integer
              example: 631000000
            goodwill:
              type: integer
              example: 12830000000
            total_liabilities:
              type: integer
              example: 16659000000
            current_liabilities:
              type: integer
              example: 9039000000
            accounts_payable:
              type: integer
              example: 360000000
            long_term_debt:
              type: integer
              example: 6166000000
            total_debt:
              type: integer
              example: 6166000000
            stockholders_equity:
              type: integer
              example: 11448000000
            retained_earnings:
              type: integer
              example: 41744000000
            working_capital:
              type:
              - integer
              - 'null'
              example: -607100000
        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