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

# List result companies for a run

> Returns the companies produced by a run of the strategy. By default this reads the strategy's active version and its latest completed run. Pass `asOfDate`, `versionId`, or both to select a different run. A completed run with no qualifying companies returns an empty array.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/companies
openapi: 3.0.0
info:
  title: Noonum API v2
  version: 2.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create and manage investment strategies, portfolios, and backtests. The API
    covers the full strategy lifecycle, including creation and editing, the
    archive and revive flow, version submission and run state, result companies,
    evidence, factsheets, exposures, and taxonomy.
servers:
  - url: https://api.noonum.ai/v2
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and manage your own investment strategies.
  - name: Helper
    description: >-
      Shared utilities for company lookup and search, objective tooling, and a
      health check.
  - name: Portfolios
    description: Create, read, update, and delete portfolios.
  - name: Backtest
    description: Run a standalone backtest on a portfolio of companies.
paths:
  /strategies/{strategyId}/companies:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy.
    get:
      tags:
        - UserStrategies
      summary: List result companies for a run
      description: >-
        Returns the companies produced by a run of the strategy. By default this
        reads the strategy's active version and its latest completed run. Pass
        `asOfDate`, `versionId`, or both to select a different run. A completed
        run with no qualifying companies returns an empty array.
      operationId: app.api.v2.strategies.companies
      parameters:
        - name: asOfDate
          in: query
          required: false
          description: >-
            The as-of date in `YYYY-MM-DD` format that selects a specific run of
            the version. When omitted, the latest completed run for the version
            is used.
          schema:
            type: string
            format: date
        - name: versionId
          in: query
          required: false
          description: >-
            The version to read. When omitted, the strategy's active version is
            used.
          schema:
            type: string
            format: uuid
        - name: includeReasoning
          in: query
          required: false
          description: When `true`, includes the reasoning text for each company.
          schema:
            type: boolean
            default: false
        - name: scoringMinMarketCap
          in: query
          required: false
          description: >-
            Minimum market cap in USD for the conviction score calculation.
            Companies below this threshold receive a `convictionScore` of 0.
          schema:
            type: number
            default: 500000000
      responses:
        '200':
          description: The list of companies, empty when the run produced none.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: A company produced by a strategy run.
                  required:
                    - id
                    - symbol
                    - name
                    - isin
                    - exchange
                    - market
                    - sector
                    - industry
                    - marketCap
                    - volAvg
                    - linguisticBeta
                    - marketBuzz
                    - active
                  properties:
                    id:
                      type: string
                      format: uuid
                    symbol:
                      type: string
                      example: TSLA
                    name:
                      type: string
                      example: Tesla, Inc.
                    isin:
                      type: string
                      nullable: true
                    figi:
                      type: string
                      nullable: true
                      description: >-
                        Bloomberg Financial Instrument Global Identifier (FIGI)
                        for the listing.
                    exchange:
                      type: string
                      example: NASDAQ
                    market:
                      type: string
                      nullable: true
                    mic:
                      type: string
                      nullable: true
                      description: >-
                        ISO 10383 operating market identifier code for the
                        listing exchange.
                    sector:
                      type: string
                      nullable: true
                    industry:
                      type: string
                      nullable: true
                    marketCap:
                      type: number
                      nullable: true
                    volAvg:
                      type: number
                      format: float
                      nullable: true
                    linguisticBeta:
                      type: number
                      format: float
                    marketBuzz:
                      type: number
                      format: float
                    reasoning:
                      type: string
                      nullable: true
                      description: >-
                        Why the company was included. Present only when
                        `includeReasoning` is `true`.
                    convictionScore:
                      type: number
                      format: float
                      nullable: true
                      description: >-
                        Conviction score between 0 and 1 that combines market
                        buzz and linguistic beta. A higher score indicates a
                        stronger thematic signal on both dimensions.
                    active:
                      type: boolean
                      description: Whether the company is currently active.
        '404':
          description: The strategy or version was not found, or has no completed run.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````