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

# Retrieve company reasoning and evidence

> Returns the reasoning and supporting evidence behind a company's inclusion or exclusion in the run.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/companies/{companyId}
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/{companyId}:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy.
      - name: companyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Company (issuer) ID in the Noonum database.
    get:
      tags:
        - UserStrategies
      summary: Retrieve company reasoning and evidence
      description: >-
        Returns the reasoning and supporting evidence behind a company's
        inclusion or exclusion in the run.
      operationId: app.api.v2.strategies.companies_get
      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
      responses:
        '200':
          description: >-
            The reasoning and evidence for the company. A company absent from
            the run still returns 200, with reasoning that states no evidence is
            available.
          content:
            application/json:
              schema:
                type: object
                description: The reasoning and supporting evidence for a single company.
                required:
                  - reasoning
                  - summaries
                  - isIncluded
                properties:
                  reasoning:
                    description: Why the company was included or excluded.
                    type: string
                    nullable: true
                  summaries:
                    description: The evidence backing the reasoning.
                    type: array
                    items:
                      type: object
                      description: A piece of evidence supporting a company's inclusion.
                      required:
                        - provider
                        - pubDate
                        - text
                      properties:
                        provider:
                          type: string
                          description: Source of the evidence.
                          example: Reuters
                        pubDate:
                          type: integer
                          format: int64
                          description: Publication date as a Unix timestamp.
                        text:
                          type: string
                          description: The evidence text.
                  isIncluded:
                    description: Whether the company was included in the run.
                    type: boolean
        '400':
          description: The `companyId` is not a valid UUID.
        '404':
          description: The strategy, version, or run was not found.
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`

````