> ## 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 evidence for included companies

> Returns the supporting evidence for every company included in the selected run, one entry per company.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/evidences
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}/evidences:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy.
    get:
      tags:
        - UserStrategies
      summary: List evidence for included companies
      description: >-
        Returns the supporting evidence for every company included in the
        selected run, one entry per company.
      operationId: app.api.v2.strategies.evidences
      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 evidence for each included company, returned as an empty list
            when the run has none.
          content:
            application/json:
              schema:
                type: object
                required:
                  - evidences
                properties:
                  evidences:
                    type: array
                    items:
                      type: object
                      description: >-
                        A company's reasoning and supporting evidence, keyed by
                        company ID.
                      required:
                        - companyId
                        - reasoning
                        - summaries
                        - isIncluded
                      properties:
                        companyId:
                          description: Identifier of the company.
                          type: string
                          format: uuid
                        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
        '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`

````