> ## 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.

# Balance Sheet

> Retrieve an as-reported balance sheet for a US issuer by SEC CIK and period end date. Resolves across 10-Q, 10-K, and 20-F filings (including amendments), preferring the original filing that first reported the period. Balance sheets are point-in-time snapshots; reporting_type in the response is always 'instant'.



## OpenAPI

````yaml openapi-us get /api/us/v0/financial-statements/balance-sheet
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/balance-sheet:
    get:
      tags:
        - Financial Statements
      summary: Balance Sheet
      description: >-
        Retrieve an as-reported balance sheet for a US issuer by SEC CIK and
        period end date. Resolves across 10-Q, 10-K, and 20-F filings (including
        amendments), preferring the original filing that first reported the
        period. Balance sheets are point-in-time snapshots; reporting_type in
        the response is always 'instant'.
      operationId: getUSBalanceSheet
      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: >-
            Balance sheet 'as of' date in YYYY-MM-DD format. Must match an
            instant column reported in the filing's XBRL data.
          schema:
            type: string
            format: date
            example: '2025-09-27'
      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: balance_sheet
                  reporting_type: instant
                  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:
                    cash_and_cash_equivalents_at_carrying_value: 54670000000
                    assets: 331233000000
                    liabilities: 265327000000
                    stockholders_equity: 65906000000
        '400':
          description: >-
            Invalid request. cik must be a 10-digit string and period_end_date
            must be YYYY-MM-DD.
          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

````