> ## 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 Company Statement Tables

> Return filing tables while preserving printed rows, columns, and headings.

Requires paid access.



## OpenAPI

````yaml /openapi.json get /v1/companies/{company_id}/statement-tables
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/companies/{company_id}/statement-tables:
    get:
      tags:
        - Companies
      summary: Get Company Statement Tables
      description: >-
        Return filing tables while preserving printed rows, columns, and
        headings.


        Requires paid access.
      operationId: get_v1_companies_company_id_statement-tables
      parameters:
        - name: company_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Company Id
        - name: filing_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Filing Id
        - name: statement_type
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - income_statement
                  - balance_sheet
                  - cash_flow
                  - changes_in_equity
                type: string
              - type: 'null'
            title: Statement Type
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 20
            title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportedStatementResponse'
        '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
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: not_found
                      code: not_found
                      message: Company not found
                      request_id: 9f5237bc-7d8c-4a9d-9c1f-fbd4ef236cf9
        '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:
    ReportedStatementResponse:
      properties:
        company_id:
          type: string
          format: uuid
          title: Company Id
        tables:
          items:
            $ref: '#/components/schemas/ReportedStatementTableRead'
          type: array
          title: Tables
      type: object
      required:
        - company_id
      title: ReportedStatementResponse
      description: Published filing tables for one company and statement type.
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    ReportedStatementTableRead:
      properties:
        table_id:
          type: string
          format: uuid
          title: Table Id
        filing_id:
          type: string
          format: uuid
          title: Filing Id
        filing_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Filing Title
        filing_published_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Filing Published At
        page_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Number
        statement_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Statement Type
        columns:
          items:
            $ref: '#/components/schemas/ReportedStatementColumnRead'
          type: array
          title: Columns
        rows:
          items:
            $ref: '#/components/schemas/ReportedStatementRowRead'
          type: array
          title: Rows
      type: object
      required:
        - table_id
        - filing_id
      title: ReportedStatementTableRead
      description: A published statement table with its printed structure and values.
    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'
    ReportedStatementColumnRead:
      properties:
        column_id:
          type: string
          format: uuid
          title: Column Id
        column_key:
          type: string
          title: Column Key
        order:
          type: integer
          title: Order
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope
        scope_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Scope Label
        period_end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Period End Date
        period_basis:
          anyOf:
            - type: string
            - type: 'null'
          title: Period Basis
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        value_scale:
          anyOf:
            - type: string
            - type: 'null'
          title: Value Scale
        is_comparative:
          type: boolean
          title: Is Comparative
          default: false
      type: object
      required:
        - column_id
        - column_key
        - order
      title: ReportedStatementColumnRead
      description: One printed column from a filing statement table.
    ReportedStatementRowRead:
      properties:
        row_id:
          type: string
          format: uuid
          title: Row Id
        parent_row_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Parent Row Id
        order:
          type: integer
          title: Order
        depth:
          type: integer
          title: Depth
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        label:
          type: string
          title: Label
        note_ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Note Ref
        value_unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Value Unit
        cells:
          items:
            $ref: '#/components/schemas/ReportedStatementCellRead'
          type: array
          title: Cells
      type: object
      required:
        - row_id
        - order
        - depth
        - label
      title: ReportedStatementRowRead
      description: One printed row and its values, without a standardized metric mapping.
    ReportedStatementCellRead:
      properties:
        value_id:
          type: string
          format: uuid
          title: Value Id
        column_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Column Id
        raw_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Raw Text
        numeric_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Numeric Value
        statement_cell_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Statement Cell Id
        source_region:
          anyOf:
            - $ref: '#/components/schemas/ReportedStatementSourceRegionRead'
            - type: 'null'
      type: object
      required:
        - value_id
      title: ReportedStatementCellRead
      description: One value at the intersection of a printed row and column.
    ReportedStatementSourceRegionRead:
      properties:
        page_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Number
        page:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page
        row_index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Row Index
        column_index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Column Index
      type: object
      title: ReportedStatementSourceRegionRead
      description: Customer-safe position metadata for locating a printed statement value.
  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.