> ## 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 a version's runs by date

> Returns one entry per as-of date of the selected version, newest date first, with the state of its latest run and whether a completed run can be read. The owner can pass any version; anyone else sees only the active version.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies/{strategyId}/runs
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.
  - name: Segments
    description: >-
      Companies' business segments, grouped into segment groups and tagged to
      GICS, NAICS and ICB industries, and the companies most similar to a
      company by the segments they share. You read a company's segment data once
      you subscribe to the company. A subscription lasts 365 days and cannot be
      cancelled or moved to another company; your plan sets how many you can
      hold at once, and `GET /segments/subscriptions` lists them.
  - name: Usage
    description: Read your plan, your remaining credits, and your credit usage.
paths:
  /strategies/{strategyId}/runs:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
          pattern: >-
            ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        description: UUID of the strategy.
    get:
      tags:
        - UserStrategies
      summary: List a version's runs by date
      description: >-
        Returns one entry per as-of date of the selected version, newest date
        first, with the state of its latest run and whether a completed run can
        be read. The owner can pass any version; anyone else sees only the
        active version.
      operationId: app.api.v2.strategies.runs
      parameters:
        - 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
            pattern: >-
              ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
      responses:
        '200':
          description: >-
            The version's run dates. The list is empty when the strategy has no
            active version.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: The runs of one version on one as-of date.
                  required:
                    - as_of_date
                    - kind
                    - status
                    - has_result
                    - factsheet_status
                    - started_at
                    - completed_at
                  properties:
                    as_of_date:
                      type: string
                      format: date
                    kind:
                      description: Whether the date's latest run is live or historical.
                      type: string
                      enum:
                        - live
                        - historical
                    status:
                      description: >-
                        Raw status of the date's latest run, with the codes of
                        `StrategyVersion.status`.
                      type: integer
                    has_result:
                      description: >-
                        Whether a completed run exists on this date, so its
                        results can be read.
                      type: boolean
                    factsheet_status:
                      description: >-
                        Factsheet state of the completed run on this date, as in
                        `StrategyVersion.factsheet_status`. Null when there is
                        none.
                      type: string
                      enum:
                        - ready
                        - generating
                        - not_requested
                        - unavailable
                      nullable: true
                    started_at:
                      description: >-
                        When the date's latest run started, or null before it
                        starts.
                      type: string
                      format: date-time
                      nullable: true
                    completed_at:
                      description: >-
                        When the date's latest run completed, or null until it
                        does.
                      type: string
                      format: date-time
                      nullable: true
        '404':
          description: The strategy or version 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`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.