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

# Get a standardized balance sheet

> Return standardized balance-sheet metrics for a ticker or company UUID.

Requires paid access.



## OpenAPI

````yaml /openapi.json get /v1/company/financials/balance-sheet/standardized
openapi: 3.1.0
info:
  title: Rangler API
  version: 1.0.0
  description: >-
    Customer-facing Rangler API for companies, standardized financials, filings,
    funds, market data, events, and webhooks.
servers:
  - url: https://api.rangler.co
    description: Live
  - url: https://sandbox-api.rangler.co
    description: Sandbox
security: []
tags:
  - name: Analyst estimates
    description: Consensus forecasts, revisions, contributor accuracy, and source evidence.
  - name: Analyst recommendations
    description: Analyst ratings, target-price views, and company recommendation history.
  - name: Calendar
    description: Company events and calendar exports.
  - name: Companies
    description: >-
      Company lookup, issuer details, dividends, daily trades, meeting media,
      and mentions.
  - name: Events
    description: >-
      Read earlier events and check for missed deliveries across the market, a
      company, or a fund.
  - name: Financials
    description: >-
      Standardized financial statements, reported tables, ratios, and links to
      filing sources.
  - name: Filings
    description: Filings, board changes, insider dealings, and extracted filing mentions.
  - name: Funds
    description: Fund directories, disclosures, snapshots, holdings, and performance data.
  - name: Markets
    description: Market directories and regular-session clock data.
  - name: News
    description: Company news developments and company-filtered news search.
paths:
  /v1/company/financials/balance-sheet/standardized:
    get:
      tags:
        - Financials
      summary: Get a standardized balance sheet
      description: |-
        Return standardized balance-sheet metrics for a ticker or company UUID.

        Requires paid access.
      operationId: get_v1_company_financials_balance-sheet_standardized
      parameters:
        - name: company
          in: query
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              Rangler company UUID or exchange ticker, matched
              case-insensitively.
            title: Company
          description: Rangler company UUID or exchange ticker, matched case-insensitively.
        - name: countryCode
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 2
                maxLength: 2
              - type: 'null'
            description: >-
              ISO 3166-1 alpha-2 market code. Use it when a ticker is shared
              across markets.
            title: Countrycode
          description: >-
            ISO 3166-1 alpha-2 market code. Use it when a ticker is shared
            across markets.
        - name: currency
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^(?:native|[A-Za-z]{3})$
              - type: 'null'
            description: Display currency. Use native or an ISO 4217 currency code.
            title: Currency
          description: Display currency. Use native or an ISO 4217 currency code.
        - name: periodType
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: >-
              Period filter. Repeat or use a comma-separated list: annual,
              quarterly, semi-annual, ltm, ytd, latest. Defaults to annual.
            title: Periodtype
          description: >-
            Period filter. Repeat or use a comma-separated list: annual,
            quarterly, semi-annual, ltm, ytd, latest. Defaults to annual.
        - name: scope
          in: query
          required: false
          schema:
            enum:
              - auto
              - consolidated
              - separate
              - unspecified
            type: string
            description: >-
              Statement scope. Auto selects the strongest available company or
              group view.
            default: auto
            title: Scope
          description: >-
            Statement scope. Auto selects the strongest available company or
            group view.
        - name: scopeLabel
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 160
                minLength: 1
              - type: 'null'
            description: >-
              Optional reported subject label used to disambiguate statement
              scope.
            title: Scopelabel
          description: >-
            Optional reported subject label used to disambiguate statement
            scope.
        - name: includeSources
          in: query
          required: false
          schema:
            type: boolean
            description: Include source-cell references for the returned metrics.
            default: true
            title: Includesources
          description: Include source-cell references for the returned metrics.
        - name: includeMetadata
          in: query
          required: false
          schema:
            type: boolean
            description: Embed definitions for the returned metrics.
            default: false
            title: Includemetadata
          description: Embed definitions for the returned metrics.
        - name: periodLimit
          in: query
          required: false
          schema:
            type: integer
            maximum: 40
            minimum: 1
            description: Maximum periods returned from each requested series.
            default: 12
            title: Periodlimit
          description: Maximum periods returned from each requested series.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatementFinancialsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: unauthorized
                      code: unauthorized
                      message: Authentication required.
                      request_id: 28fa6152-7081-492e-8a7e-00beb237b689
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: forbidden
                      code: forbidden
                      message: Paid access is required.
                      request_id: 5c253b3e-778e-4a58-aaf8-07cb21e03563
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: validation_error
                      code: validation_error
                      message: Request validation failed
                      request_id: c5964dca-d290-4465-a3dc-f92d42aa9b17
                      details:
                        - type: missing
                          loc:
                            - query
                            - ticker
                          msg: Field required
                          input: null
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: rate_limit_exceeded
                      code: rate_limit_exceeded
                      message: Rate limit exceeded
                      request_id: cc4d369a-2c69-4ee2-909e-985ea35d14a9
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: internal_server_error
                      code: internal_server_error
                      message: Internal Server Error
                      request_id: 70b63aba-b8a3-41c2-bb0c-fbe67d84d37d
      security:
        - RanglerApiKey: []
components:
  schemas:
    StatementFinancialsResponse:
      properties:
        company_id:
          type: string
          format: uuid
          title: Company Id
        company:
          $ref: '#/components/schemas/StatementCompanyReference'
        issuer_company:
          anyOf:
            - $ref: '#/components/schemas/StatementCompanyReference'
            - type: 'null'
          description: >-
            Issuer that owns the statements when the selected company is a
            separate listed security.
        scope:
          type: string
          enum:
            - consolidated
            - separate
            - unspecified
          title: Scope
        scope_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope Label
        selected_subject:
          anyOf:
            - type: string
            - type: 'null'
          title: Selected Subject
        catalog_version:
          type: string
          title: Catalog Version
          description: Version of the metric catalog used to produce this response.
        unit_convention:
          additionalProperties:
            $ref: '#/components/schemas/StatementUnitConvention'
          type: object
          title: Unit Convention
          description: >-
            Rules for interpreting the unit and scale of every value in the
            response.
        available_scopes:
          items:
            $ref: '#/components/schemas/StatementScopeOption'
          type: array
          title: Available Scopes
        available_reported_currencies:
          items:
            type: string
          type: array
          title: Available Reported Currencies
        available_display_currencies:
          items:
            type: string
          type: array
          title: Available Display Currencies
          description: >-
            Display modes the server can produce without mixing currencies or
            inventing FX rates.
        selected_reported_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Selected Reported Currency
        reported_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Reported Currency
        display_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Currency
        periods:
          items:
            $ref: '#/components/schemas/StatementFinancialPeriod'
          type: array
          title: Periods
        trailing_periods:
          items:
            $ref: '#/components/schemas/StatementFinancialPeriod'
          type: array
          title: Trailing Periods
        metric_metadata:
          additionalProperties:
            $ref: '#/components/schemas/StatementMetricDefinitionRead'
          type: object
          title: Metric Metadata
        ratio_metadata:
          additionalProperties:
            $ref: '#/components/schemas/StatementRatioDefinitionRead'
          type: object
          title: Ratio Metadata
        growth_metadata:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Growth Metadata
        historical_cagrs:
          additionalProperties: true
          type: object
          title: Historical Cagrs
      type: object
      required:
        - company_id
        - company
        - scope
        - catalog_version
        - unit_convention
      title: StatementFinancialsResponse
      description: >-
        Standardized company financials with metric definitions and filing
        sources.
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    StatementCompanyReference:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        ticker:
          type: string
          title: Ticker
        exchange:
          anyOf:
            - type: string
            - type: 'null'
          title: Exchange
        country_code:
          type: string
          title: Country Code
      type: object
      required:
        - id
        - name
        - ticker
        - country_code
      title: StatementCompanyReference
      description: Resolved issuer identity for a financial response.
    StatementUnitConvention:
      properties:
        label:
          type: string
          title: Label
        description:
          type: string
          title: Description
        value_representation:
          type: string
          title: Value Representation
        scale:
          type: integer
          title: Scale
          default: 1
        currency_field:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency Field
      type: object
      required:
        - label
        - description
        - value_representation
      title: StatementUnitConvention
    StatementScopeOption:
      properties:
        scope:
          type: string
          enum:
            - consolidated
            - separate
            - unspecified
          title: Scope
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        scope_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope Label
      type: object
      required:
        - scope
      title: StatementScopeOption
    StatementFinancialPeriod:
      properties:
        period_id:
          type: string
          title: Period Id
          description: >-
            Identifier for this period within the selected company and reporting
            scope. Use it with company_id, scope, scope_label, and currency when
            storing results.
        period_end_date:
          type: string
          format: date
          title: Period End Date
          description: Date on which the reported accounting period ends.
        calendar_year:
          type: integer
          title: Calendar Year
          description: Calendar year containing period_end_date.
        calendar_quarter:
          type: integer
          title: Calendar Quarter
          description: Calendar quarter, from 1 to 4, containing period_end_date.
        fiscal_year:
          anyOf:
            - type: integer
            - type: 'null'
          title: Fiscal Year
          description: >-
            Issuer accounting year. It can differ from calendar_year when the
            year end is not 31 December.
        fiscal_quarter:
          anyOf:
            - type: integer
            - type: 'null'
          title: Fiscal Quarter
          description: >-
            Issuer accounting quarter, from 1 to 4. It can differ from
            calendar_quarter.
        period_family:
          anyOf:
            - type: string
              enum:
                - annual
                - quarterly
                - semi_annual
                - nine_month
                - trailing
            - type: 'null'
          title: Period Family
        period_granularity:
          anyOf:
            - type: string
              enum:
                - full_year
                - quarter
                - half_year
                - year_to_date
                - trailing_twelve_months
            - type: 'null'
          title: Period Granularity
        reporting_period:
          anyOf:
            - type: string
            - type: 'null'
          title: Reporting Period
        period_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Period Type
        duration_months:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration Months
        is_derived_period:
          type: boolean
          title: Is Derived Period
          default: false
        is_restated:
          type: boolean
          title: Is Restated
          default: false
        restated_metrics:
          items:
            type: string
          type: array
          title: Restated Metrics
        scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope
        scope_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope Label
        income_basis:
          anyOf:
            - type: string
            - type: 'null'
          title: Income Basis
        reported_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Reported Currency
          description: >-
            ISO 4217 currency of the selected reported statement before display
            conversion.
        display_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Currency
          description: ISO 4217 currency used for monetary values returned in this period.
        currency_conversion:
          anyOf:
            - $ref: '#/components/schemas/StatementCurrencyConversion'
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
          description: >-
            ISO 4217 currency for this period after any requested display
            conversion. It applies to currency and per-share values; consult
            metric_metadata for each metric's unit class.
        metrics:
          additionalProperties:
            anyOf:
              - type: number
              - type: 'null'
          type: object
          title: Metrics
          description: >-
            Standardized values. Currency amounts are base units, per-share
            values are major currency units per share, and share counts are
            individual shares.
        metric_origins:
          additionalProperties:
            type: string
            enum:
              - reported
              - derived_line_item
              - derived_period
              - unknown
          type: object
          title: Metric Origins
          description: >-
            Origin of each returned metric value. Currency conversion is
            described separately by currency_conversion and does not change a
            metric's accounting origin.
        ratios:
          additionalProperties:
            anyOf:
              - type: number
              - type: 'null'
          type: object
          title: Ratios
          description: >-
            Derived values. Percent-unit ratios are decimal fractions;
            ratio-unit values are decimal multiples.
        sources:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/StatementFinancialSourceReference'
              type: object
            - type: 'null'
          title: Sources
        quarter_derivation:
          anyOf:
            - $ref: '#/components/schemas/StatementQuarterDerivationRead'
            - type: 'null'
        ttm_components:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Ttm Components
        valuation_inputs:
          anyOf:
            - $ref: '#/components/schemas/StatementValuationInputsRead'
            - type: 'null'
      type: object
      required:
        - period_id
        - period_end_date
        - calendar_year
        - calendar_quarter
      title: StatementFinancialPeriod
      description: >-
        One reported or derived financial period.


        Metrics, ratios, and sources are grouped by name so Rangler can add
        newly

        standardized line items without changing the overall response format.
    StatementMetricDefinitionRead:
      properties:
        key:
          type: string
          title: Key
        label:
          type: string
          title: Label
        definition:
          type: string
          title: Definition
        statement_types:
          items:
            type: string
          type: array
          title: Statement Types
        unit:
          type: string
          title: Unit
        display_unit:
          type: string
          title: Display Unit
        value_representation:
          type: string
          title: Value Representation
        source:
          type: string
          const: reported
          title: Source
          default: reported
      type: object
      required:
        - key
        - label
        - definition
        - unit
        - display_unit
        - value_representation
      title: StatementMetricDefinitionRead
    StatementRatioDefinitionRead:
      properties:
        key:
          type: string
          title: Key
        label:
          type: string
          title: Label
        definition:
          type: string
          title: Definition
        formula:
          type: string
          title: Formula
        category:
          type: string
          title: Category
        unit:
          type: string
          title: Unit
        value_representation:
          type: string
          title: Value Representation
        dependencies:
          items:
            type: string
          type: array
          title: Dependencies
        uses_prior_period:
          type: boolean
          title: Uses Prior Period
          default: false
        uses_market_data:
          type: boolean
          title: Uses Market Data
          default: false
        source:
          type: string
          const: derived
          title: Source
          default: derived
      type: object
      required:
        - key
        - label
        - definition
        - formula
        - category
        - unit
        - value_representation
      title: StatementRatioDefinitionRead
    ErrorObject:
      type: object
      required:
        - type
        - code
        - message
        - request_id
      properties:
        type:
          type: string
        code:
          type: string
        message:
          type: string
        request_id:
          type: string
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: array
              items:
                additionalProperties: true
                type: object
            - type: 'null'
    StatementCurrencyConversion:
      properties:
        source_currency:
          type: string
          title: Source Currency
        target_currency:
          type: string
          title: Target Currency
        rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Rate
        rate_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Rate Date
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
      type: object
      required:
        - source_currency
        - target_currency
      title: StatementCurrencyConversion
      description: Period-date currency conversion applied to monetary metrics.
    StatementFinancialSourceReference:
      properties:
        cell_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Cell Id
        page:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page
        filing_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Filing Id
        derivation:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Derivation
      type: object
      title: StatementFinancialSourceReference
      description: Customer-safe filing reference for one standardized value.
    StatementQuarterDerivationRead:
      properties:
        current_period_end_date:
          type: string
          format: date
          title: Current Period End Date
        current_income_basis:
          type: string
          title: Current Income Basis
        previous_period_end_date:
          type: string
          format: date
          title: Previous Period End Date
        previous_income_basis:
          type: string
          title: Previous Income Basis
      type: object
      required:
        - current_period_end_date
        - current_income_basis
        - previous_period_end_date
        - previous_income_basis
      title: StatementQuarterDerivationRead
    StatementValuationInputsRead:
      properties:
        price:
          anyOf:
            - type: number
            - type: 'null'
          title: Price
        price_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Price Currency
        price_as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Price As Of Date
        source_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Source Price
        source_price_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Price Currency
        statement_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Statement Currency
        fx_rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Fx Rate
        fx_rate_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Fx Rate Date
        fx_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Fx Status
        shares:
          anyOf:
            - type: number
            - type: 'null'
          title: Shares
        eps:
          anyOf:
            - type: number
            - type: 'null'
          title: Eps
        eps_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Eps Source
      type: object
      title: StatementValuationInputsRead
  securitySchemes:
    RanglerApiKey:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.