> ## 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 a version and its run state

> Returns the version's metadata and run state. Without `asOfDate`, the response reports the version's overall state, meaning the status of its most recent run along with `latest_run_date` and `runs_count`. With `asOfDate`, the response reports the state of the run on that date, and the overall fields are null.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/versions/{versionId}
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/{versionId}:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy.
      - name: versionId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the strategy version.
    get:
      tags:
        - UserStrategies
      summary: Retrieve a version and its run state
      description: >-
        Returns the version's metadata and run state. Without `asOfDate`, the
        response reports the version's overall state, meaning the status of its
        most recent run along with `latest_run_date` and `runs_count`. With
        `asOfDate`, the response reports the state of the run on that date, and
        the overall fields are null.
      operationId: app.api.v2.strategies.version_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
      responses:
        '200':
          description: The version's metadata and run state.
          content:
            application/json:
              schema:
                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 or version was not found, or has no run on the given
            date.
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`

````