> ## 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 strategy versions

> Returns the strategy's versions, newest first. The owner sees every version. A non-owner viewing a public strategy sees only the active version. Each entry includes the version's metadata and its latest run state.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/versions
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}/versions:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy.
    get:
      tags:
        - UserStrategies
      summary: List strategy versions
      description: >-
        Returns the strategy's versions, newest first. The owner sees every
        version. A non-owner viewing a public strategy sees only the active
        version. Each entry includes the version's metadata and its latest run
        state.
      operationId: app.api.v2.strategies.versions
      responses:
        '200':
          description: The list of versions, each with its latest run state.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: >-
                    A saved version of a strategy together with its run state.
                    When no `as_of_date` is supplied, the response summarizes
                    the version overall and populates `latest_run_date` and
                    `runs_count`. When an `as_of_date` is supplied, the response
                    describes the run on that date, echoes `as_of_date`, and
                    leaves the summary-only fields null.
                  required:
                    - version_id
                    - strategy_id
                    - objective
                    - exclusions
                    - created_at
                    - is_active
                    - status
                    - completed
                    - has_factsheet
                  properties:
                    version_id:
                      description: Unique identifier for this version.
                      type: string
                      format: uuid
                    strategy_id:
                      description: Identifier of the strategy this version belongs to.
                      type: string
                      format: uuid
                    objective:
                      description: The normalized objective captured for this version.
                      type: string
                    exclusions:
                      description: The exclusion phrases captured for this version.
                      type: array
                      items:
                        type: string
                    created_at:
                      type: string
                      format: date-time
                    is_active:
                      description: Whether this version is the strategy's active version.
                      type: boolean
                    status:
                      description: >-
                        Raw run status code. For example, `1` means pending,
                        `100` means done, and a negative value means failed.
                      type: integer
                      nullable: true
                    completed:
                      type: boolean
                    has_factsheet:
                      type: boolean
                    started_at:
                      type: string
                      format: date-time
                      nullable: true
                    completed_at:
                      type: string
                      format: date-time
                      nullable: true
                    as_of_date:
                      description: >-
                        The run's as-of date, echoed when an `as_of_date` was
                        supplied, otherwise null.
                      type: string
                      format: date
                      nullable: true
                    latest_run_date:
                      description: >-
                        The version's latest completed run date, or null when an
                        `as_of_date` was supplied.
                      type: string
                      format: date
                      nullable: true
                    runs_count:
                      description: >-
                        Total number of runs for the version, or null when an
                        `as_of_date` was supplied.
                      type: integer
                      nullable: true
        '404':
          description: The strategy 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`

````