> ## Documentation Index
> Fetch the complete documentation index at: https://docs.itoflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get strategy detail

> Returns a single strategy with full detail. User must own the strategy or it must be an Itoflow-created strategy.

Operation ID: get__strategies_id_.



## OpenAPI

````yaml /openapi/itoflow-public.openapi.json get /strategies/{id}
openapi: 3.1.0
info:
  description: >-
    All Itoflow APIs are experimental and may change without notice. Read-only
    operations marked interactive can be tried from the documentation; the
    others are reference-only.
  title: Itoflow Developer API
  version: 1.0.0
servers:
  - description: Itoflow API
    url: https://api.itoflow.ai
security: []
tags:
  - name: Account
  - name: Billing
  - name: Brokers
  - name: Chat
  - name: Connected MCP servers
  - name: GitHub
  - name: Market data
  - name: Monitors
  - name: Notifications
  - name: Portfolios
  - name: Risk runs
  - name: Sharing and data
  - name: Strategies
paths:
  /strategies/{id}:
    get:
      tags:
        - Strategies
      summary: Get strategy detail
      description: >-
        Returns a single strategy with full detail. User must own the strategy
        or it must be an Itoflow-created strategy.


        Operation ID: get__strategies_id_.
      operationId: get__strategies_id_
      parameters:
        - description: Resource UUID
          in: path
          name: id
          required: true
          schema:
            description: Resource UUID
            example: 550e8400-e29b-41d4-a716-446655440000
            format: uuid
            type: string
        - description: Include immutable version history for the strategy (true/false)
          in: query
          name: includeVersionHistory
          required: false
          schema:
            description: Include immutable version history for the strategy (true/false)
            example: 'true'
            type: string
        - description: >-
            Also return this historical revision's full mandate text (positive
            version number)
          in: query
          name: mandateVersion
          required: false
          schema:
            description: >-
              Also return this historical revision's full mandate text (positive
              version number)
            example: '2'
            pattern: ^[1-9]\d*$
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StrategyDetailResponse'
          description: Strategy detail
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Server error
      security:
        - bearerAuth: []
components:
  schemas:
    StrategyDetailResponse:
      properties:
        strategy:
          $ref: '#/components/schemas/StrategyDetail'
      required:
        - strategy
      type: object
    Error:
      properties:
        available:
          description: Optional available amount or value
          type: string
        billing_action:
          $ref: '#/components/schemas/BillingAction'
        code:
          description: Machine-readable error code
          type: string
        currentVersion:
          description: Current server-side version, when relevant
          type: number
        details:
          description: Optional structured error details
        error:
          description: Error type or code
          type: string
        expectedVersion:
          description: Client-provided expected version, when relevant
          type: number
        message:
          description: Human-readable error message
          type: string
        requested:
          description: Optional requested amount or value
          type: string
        usage:
          description: Optional usage metadata for limit errors
      required:
        - error
      type: object
    StrategyDetail:
      properties:
        allocationGuidance:
          $ref: '#/components/schemas/AllocationGuidanceResponse'
        cloneOfStrategyId:
          format: uuid
          type:
            - string
            - 'null'
        constraints:
          $ref: '#/components/schemas/StrategyConstraintsResponse'
        createdAt:
          type: string
        createdBy:
          type: string
        currentVersionNumber:
          type:
            - integer
            - 'null'
        description:
          type:
            - string
            - 'null'
        executionStatus:
          type:
            - string
            - 'null'
        executionTriggers:
          additionalProperties: {}
          type:
            - object
            - 'null'
        id:
          format: uuid
          type: string
        initialCapital:
          type: string
        isActive:
          type: boolean
        lastExecutionAt:
          type:
            - string
            - 'null'
        mandatePending:
          description: >-
            True only for a shell strategy created alongside an imported
            portfolio: tracked but not yet managed, because no mandate has been
            written. Cleared once the first real mandate (strategyContent) is
            saved.
          type: boolean
        mandateVersion:
          description: >-
            One historical revision's full mandate text, present when
            mandateVersion was requested; null when that version does not exist.
          properties:
            change_description:
              type:
                - string
                - 'null'
            effective_from:
              type: string
            effective_to:
              type:
                - string
                - 'null'
            strategy_content:
              type:
                - string
                - 'null'
            version_number:
              type: integer
          required:
            - version_number
            - effective_from
            - effective_to
            - change_description
            - strategy_content
          type:
            - object
            - 'null'
        name:
          type: string
        owned:
          type: boolean
        portfolioId:
          format: uuid
          type: string
        promptFile:
          type:
            - string
            - 'null'
        rules:
          $ref: '#/components/schemas/StrategyRules'
        strategyContent:
          type:
            - string
            - 'null'
        triggerReferenceState:
          properties:
            portfolioValueUsd:
              type: number
            positionPrices:
              additionalProperties:
                type: number
              type: object
            positionWeights:
              additionalProperties:
                type: number
              type: object
            recordedAt:
              type: string
          required:
            - portfolioValueUsd
            - positionPrices
            - positionWeights
            - recordedAt
          type:
            - object
            - 'null'
        universe:
          items:
            type: string
          type: array
        updatedAt:
          type: string
        versionHistory:
          items:
            properties:
              change_description:
                type: string
              effective_from:
                type: string
              effective_to:
                type:
                  - string
                  - 'null'
              version_number:
                type: integer
            required:
              - version_number
              - effective_from
              - effective_to
              - change_description
            type: object
          type: array
      required:
        - id
        - name
        - description
        - promptFile
        - portfolioId
        - initialCapital
        - isActive
        - owned
        - createdBy
        - cloneOfStrategyId
        - createdAt
        - updatedAt
        - strategyContent
        - universe
        - constraints
        - rules
        - executionStatus
        - allocationGuidance
        - executionTriggers
        - lastExecutionAt
        - currentVersionNumber
        - mandatePending
        - triggerReferenceState
      type: object
    BillingAction:
      description: Action that resolves a billing-related rejection
      properties:
        href:
          type: string
        kind:
          enum:
            - upgrade
            - payment_method
            - spending_cap
            - billing
          type: string
        label:
          type: string
      required:
        - href
        - label
        - kind
      type: object
    AllocationGuidanceResponse:
      description: >-
        Canonical market_based allocation guidance. Select at least one market,
        asset class, sector, or included symbol; universe is an alternative
        source of included symbols.
      properties:
        asset_classes:
          items:
            type: string
          type: array
        created_at:
          type: string
        is_strict:
          type: boolean
        markets:
          items:
            type: string
          type: array
        notes:
          type: string
        pattern:
          enum:
            - market_based
          type: string
        sectors:
          items:
            type: string
          type: array
        symbols_avoid:
          items:
            type: string
          type: array
        symbols_include:
          items:
            type: string
          type: array
      required:
        - pattern
      type:
        - object
        - 'null'
    StrategyConstraintsResponse:
      properties:
        allowed_exchanges:
          items:
            type: string
          type:
            - array
            - 'null'
        blocked_symbols:
          items:
            type: string
          type:
            - array
            - 'null'
        is_strict:
          type: boolean
        max_drawdown_pct:
          type: number
        max_position_pct:
          type: number
        max_positions:
          type: integer
        min_cash_pct:
          type: number
        min_position_pct:
          type: number
        stop_loss_pct:
          type:
            - number
            - 'null'
        stop_on_drawdown:
          type: boolean
      type:
        - object
        - 'null'
    StrategyRules:
      description: >-
        On creation, omitted rebalance_frequency and rebalance_time_utc default
        to daily and 21:00 UTC. The create response returns the effective rules.
      properties:
        lookback_days:
          type: integer
        model_key:
          enum:
            - luna
            - sol
            - sol61
            - astra
            - sonnet55
            - opus55
            - terra61
            - haiku55
            - fusion_deep
            - fusion_quick
            - fusion_light
          type: string
        rebalance_frequency:
          enum:
            - daily
            - weekly
            - monthly
          type: string
        rebalance_time_utc:
          type: string
      type:
        - object
        - 'null'
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Itoflow access token issued for the Itoflow API.
      scheme: bearer
      type: http

````

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