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

> Returns the caller's own strategies, the public catalog, or both, depending on the `scope` parameter.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /strategies
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:
    get:
      tags:
        - UserStrategies
      summary: List strategies
      description: >-
        Returns the caller's own strategies, the public catalog, or both,
        depending on the `scope` parameter.
      operationId: app.api.v2.strategies.list_
      parameters:
        - name: scope
          in: query
          required: false
          description: >-
            Which strategies to return. `user`, the default, returns the
            caller's own non-archived strategies. `public` returns the public
            catalog of all public, non-archived, completed strategies. `all`
            returns both, with duplicates removed.
          schema:
            type: string
            enum:
              - user
              - public
              - all
            default: user
      responses:
        '200':
          description: The list of strategies.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: A user-owned investment strategy.
                  required:
                    - id
                    - user_id
                    - name
                    - exclusions
                    - public
                    - tags
                    - active_version_id
                    - draft_version_id
                    - status
                    - completed
                    - metathemes
                    - gics_sectors
                    - performance
                    - archived_at
                    - permanent_delete_at
                    - created_at
                    - updated_at
                  properties:
                    id:
                      type: string
                      format: uuid
                      example: 83d88f60-f581-4176-bb5c-e0b463d1d442
                    user_id:
                      type: string
                      example: auth0-5dba12a5654f067ba1234567
                    name:
                      type: string
                      example: Electric Vehicles
                    objective:
                      description: The strategy's investment objective.
                      type: string
                      nullable: true
                      example: >
                        The Electric Vehicles Investment Strategy is to identify
                        companies that focus on EV manufacturing, plus the
                        development of battery technology and charging station
                        infrastructure.
                    exclusions:
                      description: >-
                        Phrases used to exclude companies when building the
                        strategy.
                      type: array
                      items:
                        type: string
                    public:
                      description: Whether the strategy is visible in the public catalog.
                      type: boolean
                      example: false
                    tags:
                      description: User-defined tags for the strategy.
                      type: array
                      items:
                        type: string
                      example:
                        - Themes
                    active_version_id:
                      description: >-
                        The active, submitted version, or null when the strategy
                        has never been submitted.
                      type: string
                      format: uuid
                      nullable: true
                    draft_version_id:
                      description: >-
                        The saved version whose content matches the current
                        draft, or null when no saved version matches it.
                      type: string
                      format: uuid
                      nullable: true
                    status:
                      description: >-
                        Run status of the active version's latest live run. `0`
                        means not started or never submitted, `1` through `95`
                        means in progress, `100` means done, `-1` means error,
                        and `-2` means permanently failed. For per-version and
                        per-date detail, use `GET
                        /strategies/{strategyId}/versions/{versionId}`.
                      type: integer
                    completed:
                      description: >-
                        Whether the active version's latest live run is done,
                        meaning `status` is `100`.
                      type: boolean
                    metathemes:
                      description: >-
                        Metatheme taxonomy group IDs that classify the strategy.
                        Empty when the strategy is unclassified, and populated
                        for the curated public catalog.
                      type: array
                      items:
                        type: string
                        format: uuid
                    gics_sectors:
                      description: >-
                        GICS sector taxonomy group IDs that classify the
                        strategy. Empty when the strategy is unclassified, and
                        populated for the curated public catalog.
                      type: array
                      items:
                        type: string
                        format: uuid
                    performance:
                      description: >-
                        Sparkline performance, made up of a conviction-weighted
                        NAV time series and summary metadata, or null when no
                        sparkline has been computed yet.
                      type: object
                      nullable: true
                      properties:
                        timeSeries:
                          description: NAV points, each given as `[unix_seconds, nav]`.
                          type: array
                          items:
                            type: array
                            items:
                              type: number
                        metadata:
                          type: object
                          nullable: true
                          additionalProperties: true
                    archived_at:
                      description: >-
                        ISO-8601 timestamp of when the strategy was archived, or
                        null when not archived.
                      type: string
                      format: date-time
                      nullable: true
                    permanent_delete_at:
                      description: >-
                        ISO-8601 timestamp of when an archived strategy is
                        permanently deleted, which is 30 days after
                        `archived_at`, or null when not archived.
                      type: string
                      format: date-time
                      nullable: true
                    created_at:
                      description: ISO-8601 timestamp of when the strategy was created.
                      type: string
                      format: date-time
                    updated_at:
                      description: >-
                        ISO-8601 timestamp of when the strategy was last
                        updated.
                      type: string
                      format: date-time
                      nullable: true
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`

````