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

# List filings published by a company

> List filings published by one company in reverse chronological order.



## OpenAPI

````yaml /openapi.json get /v1/companies/{company_id}/filings
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}/filings:
    get:
      tags:
        - Companies
      summary: List filings published by a company
      description: List filings published by one company in reverse chronological order.
      operationId: get_v1_companies_company_id_filings
      parameters:
        - name: company_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Company Id
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
        - name: type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/FilingType'
              - type: 'null'
            description: Filter by filing_type
            title: Type
          description: Filter by filing_type
        - name: from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: From
        - name: to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: To
        - name: has_tables
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Has Tables
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 50
            title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingsPage'
        '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:
    FilingType:
      type: string
      enum:
        - results
        - full_financials
        - corporate_action
        - board_change
        - director_dealing
        - sustainability
        - other
      title: FilingType
    FilingsPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/FilingRead'
          type: array
          title: Data
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      type: object
      required:
        - data
      title: FilingsPage
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    FilingRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        subject_kind:
          $ref: '#/components/schemas/FilingSubjectKind'
        subject_id:
          type: string
          format: uuid
          title: Subject Id
        filing_type:
          $ref: '#/components/schemas/FilingType'
        title:
          type: string
          title: Title
        source_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Title
        period:
          anyOf:
            - type: string
            - type: 'null'
          title: Period
        published_at:
          type: string
          format: date-time
          title: Published At
        url:
          type: string
          title: Url
        has_tables:
          type: boolean
          title: Has Tables
        filing_family_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Filing Family Key
        superseded_by_filing_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Superseded By Filing Id
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
        superseded_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Superseded Reason
        badge:
          anyOf:
            - $ref: '#/components/schemas/FilingBadgeRead'
            - type: 'null'
        signal:
          anyOf:
            - $ref: '#/components/schemas/FilingSignalRead'
            - type: 'null'
        company:
          anyOf:
            - $ref: '#/components/schemas/FilingCompanySummary'
            - type: 'null'
        subject:
          anyOf:
            - $ref: '#/components/schemas/FilingSubjectRead'
            - type: 'null'
        subjects:
          items:
            $ref: '#/components/schemas/FilingSubjectRead'
          type: array
          title: Subjects
      type: object
      required:
        - id
        - subject_kind
        - subject_id
        - filing_type
        - title
        - published_at
        - url
        - has_tables
      title: FilingRead
    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'
    FilingSubjectKind:
      type: string
      enum:
        - company
        - portfolio_fund
        - debt_instrument
        - market_instrument
      title: FilingSubjectKind
    FilingBadgeRead:
      properties:
        key:
          type: string
          title: Key
        label:
          type: string
          title: Label
        color:
          type: string
          title: Color
      type: object
      required:
        - key
        - label
        - color
      title: FilingBadgeRead
    FilingSignalRead:
      properties:
        summary:
          type: string
          title: Summary
        confidence:
          type: number
          title: Confidence
        extracted_at:
          type: string
          format: date-time
          title: Extracted At
        reporting_period:
          anyOf:
            - type: string
            - type: 'null'
          title: Reporting Period
        key_points:
          items:
            type: string
          type: array
          title: Key Points
        mentioned_tickers:
          items:
            type: string
          type: array
          title: Mentioned Tickers
        dates_mentioned:
          items:
            type: string
          type: array
          title: Dates Mentioned
        risk_flags:
          items:
            type: string
          type: array
          title: Risk Flags
        corporate_actions:
          items:
            type: string
          type: array
          title: Corporate Actions
        board_changes:
          items:
            type: string
          type: array
          title: Board Changes
        metrics:
          items:
            $ref: '#/components/schemas/FilingSignalMetricRead'
          type: array
          title: Metrics
        result_details:
          anyOf:
            - $ref: '#/components/schemas/FilingResultDetailsRead'
            - type: 'null'
        corporate_action_details:
          items:
            $ref: '#/components/schemas/FilingCorporateActionDetailRead'
          type: array
          title: Corporate Action Details
        board_change_details:
          items:
            $ref: '#/components/schemas/FilingBoardChangeDetailRead'
          type: array
          title: Board Change Details
        director_dealings:
          items:
            $ref: '#/components/schemas/FilingDirectorDealingRead'
          type: array
          title: Director Dealings
          default: []
        highlights:
          items:
            $ref: '#/components/schemas/FilingHighlightRead'
          type: array
          title: Highlights
          default: []
      type: object
      required:
        - summary
        - confidence
        - extracted_at
        - key_points
        - mentioned_tickers
        - dates_mentioned
        - risk_flags
        - corporate_actions
        - board_changes
        - metrics
        - corporate_action_details
        - board_change_details
      title: FilingSignalRead
    FilingCompanySummary:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        ticker:
          type: string
          title: Ticker
        sector:
          anyOf:
            - type: string
            - type: 'null'
          title: Sector
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
      type: object
      required:
        - id
        - name
        - ticker
      title: FilingCompanySummary
    FilingSubjectRead:
      properties:
        kind:
          $ref: '#/components/schemas/FilingSubjectKind'
        id:
          type: string
          format: uuid
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
        slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Slug
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
      type: object
      required:
        - kind
        - id
      title: FilingSubjectRead
    FilingSignalMetricRead:
      properties:
        name:
          type: string
          title: Name
        value:
          type: string
          title: Value
        unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Unit
        period:
          anyOf:
            - type: string
            - type: 'null'
          title: Period
      type: object
      required:
        - name
        - value
      title: FilingSignalMetricRead
    FilingResultDetailsRead:
      properties:
        revenue:
          anyOf:
            - type: string
            - type: 'null'
          title: Revenue
        profit_before_tax:
          anyOf:
            - type: string
            - type: 'null'
          title: Profit Before Tax
        profit_after_tax:
          anyOf:
            - type: string
            - type: 'null'
          title: Profit After Tax
        earnings_per_share:
          anyOf:
            - type: string
            - type: 'null'
          title: Earnings Per Share
        dividend_per_share:
          anyOf:
            - type: string
            - type: 'null'
          title: Dividend Per Share
        dividend_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Dividend Currency
        record_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Record Date
        payment_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Payment Date
        period_end_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Period End Date
        period_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Period Type
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        value_scale:
          anyOf:
            - type: string
            - type: 'null'
          title: Value Scale
        revenue_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue Value
        cost_of_sales:
          anyOf:
            - type: number
            - type: 'null'
          title: Cost Of Sales
        gross_profit:
          anyOf:
            - type: number
            - type: 'null'
          title: Gross Profit
        operating_profit:
          anyOf:
            - type: number
            - type: 'null'
          title: Operating Profit
        ebitda:
          anyOf:
            - type: number
            - type: 'null'
          title: Ebitda
        profit_before_tax_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Profit Before Tax Value
        profit_after_tax_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Profit After Tax Value
        earnings_per_share_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Earnings Per Share Value
        total_assets:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Assets
        total_liabilities:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Liabilities
        total_equity:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Equity
        cash_and_equivalents:
          anyOf:
            - type: number
            - type: 'null'
          title: Cash And Equivalents
        dividend_per_share_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Dividend Per Share Value
        net_asset_per_share:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Asset Per Share
        dividend_payout_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Dividend Payout Ratio
        employee_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Employee Count
        personnel_expenses:
          anyOf:
            - type: number
            - type: 'null'
          title: Personnel Expenses
        capital_expenditure:
          anyOf:
            - type: number
            - type: 'null'
          title: Capital Expenditure
        operating_cash_flow:
          anyOf:
            - type: number
            - type: 'null'
          title: Operating Cash Flow
        interest_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest Income
        interest_expense:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest Expense
        net_interest_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Interest Income
        non_interest_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Non Interest Income
        operating_income:
          anyOf:
            - type: number
            - type: 'null'
          title: Operating Income
        loans_and_advances:
          anyOf:
            - type: number
            - type: 'null'
          title: Loans And Advances
        customer_deposits:
          anyOf:
            - type: number
            - type: 'null'
          title: Customer Deposits
        investment_securities:
          anyOf:
            - type: number
            - type: 'null'
          title: Investment Securities
        long_term_debt:
          anyOf:
            - type: number
            - type: 'null'
          title: Long Term Debt
        net_interest_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Interest Margin
        cost_to_income_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Cost To Income Ratio
        non_performing_loan_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Non Performing Loan Ratio
        return_on_assets:
          anyOf:
            - type: number
            - type: 'null'
          title: Return On Assets
        return_on_equity:
          anyOf:
            - type: number
            - type: 'null'
          title: Return On Equity
        financial_leverage:
          anyOf:
            - type: number
            - type: 'null'
          title: Financial Leverage
        capital_adequacy_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Capital Adequacy Ratio
        gross_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Gross Margin
        operating_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Operating Margin
        pbt_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Pbt Margin
        pat_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Pat Margin
        fcf_margin:
          anyOf:
            - type: number
            - type: 'null'
          title: Fcf Margin
        revenue_growth:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue Growth
        free_cash_flow:
          anyOf:
            - type: number
            - type: 'null'
          title: Free Cash Flow
        gearing_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Gearing Ratio
        debt_to_asset:
          anyOf:
            - type: number
            - type: 'null'
          title: Debt To Asset
        interest_coverage_ebit:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest Coverage Ebit
        interest_coverage_ocf:
          anyOf:
            - type: number
            - type: 'null'
          title: Interest Coverage Ocf
        asset_turnover:
          anyOf:
            - type: number
            - type: 'null'
          title: Asset Turnover
        capex_intensity:
          anyOf:
            - type: number
            - type: 'null'
          title: Capex Intensity
        nwc_ratio:
          anyOf:
            - type: number
            - type: 'null'
          title: Nwc Ratio
        ocf_conversion:
          anyOf:
            - type: number
            - type: 'null'
          title: Ocf Conversion
        price_to_earnings:
          anyOf:
            - type: number
            - type: 'null'
          title: Price To Earnings
        price_to_book:
          anyOf:
            - type: number
            - type: 'null'
          title: Price To Book
        revenue_segments:
          items:
            $ref: '#/components/schemas/app__schemas__filing__RevenueSegmentRead'
          type: array
          title: Revenue Segments
          default: []
      type: object
      title: FilingResultDetailsRead
    FilingCorporateActionDetailRead:
      properties:
        action_type:
          type: string
          title: Action Type
        summary:
          type: string
          title: Summary
        transaction_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Transaction Type
        amount:
          anyOf:
            - type: string
            - type: 'null'
          title: Amount
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        ratio:
          anyOf:
            - type: string
            - type: 'null'
          title: Ratio
        quantity:
          anyOf:
            - type: string
            - type: 'null'
          title: Quantity
        record_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Record Date
        payment_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Payment Date
        effective_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Effective Date
        person_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Person Name
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        holding_after:
          anyOf:
            - type: string
            - type: 'null'
          title: Holding After
      type: object
      required:
        - action_type
        - summary
      title: FilingCorporateActionDetailRead
    FilingBoardChangeDetailRead:
      properties:
        person_name:
          type: string
          title: Person Name
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        action:
          type: string
          title: Action
        effective_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Effective Date
      type: object
      required:
        - person_name
        - action
      title: FilingBoardChangeDetailRead
    FilingDirectorDealingRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        filing_id:
          type: string
          format: uuid
          title: Filing Id
        company_id:
          type: string
          format: uuid
          title: Company Id
        person_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Person Name
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        transaction_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Transaction Type
        transaction_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Transaction Date
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        price_per_share:
          anyOf:
            - type: number
            - type: 'null'
          title: Price Per Share
        quantity:
          anyOf:
            - type: number
            - type: 'null'
          title: Quantity
        amount:
          anyOf:
            - type: number
            - type: 'null'
          title: Amount
        instrument:
          anyOf:
            - type: string
            - type: 'null'
          title: Instrument
        holding_after:
          anyOf:
            - type: number
            - type: 'null'
          title: Holding After
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
        source_excerpt:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Excerpt
        source_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Page
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
      type: object
      required:
        - id
        - filing_id
        - company_id
      title: FilingDirectorDealingRead
    FilingHighlightRead:
      properties:
        category:
          type: string
          title: Category
        severity:
          type: string
          title: Severity
        topic:
          type: string
          title: Topic
        summary:
          type: string
          title: Summary
        metric_value:
          anyOf:
            - type: string
            - type: 'null'
          title: Metric Value
      type: object
      required:
        - category
        - severity
        - topic
        - summary
      title: FilingHighlightRead
    app__schemas__filing__RevenueSegmentRead:
      properties:
        segment:
          type: string
          title: Segment
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
        products:
          anyOf:
            - type: string
            - type: 'null'
          title: Products
        revenue_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue Value
        revenue_usd_value:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue Usd Value
        revenue_contribution_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Revenue Contribution Pct
      type: object
      required:
        - segment
      title: RevenueSegmentRead
  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.