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

# Get Scenario



## OpenAPI

````yaml POST /api/v1/backchannel/scenarios/{id}
openapi: 3.0.3
info:
  title: Backchannel API
  version: 1.0.0
  description: >-
    API for integrating Tilt market intelligence capabilities, including
    scenarios, topics, company news, company search, and risk analysis.
servers:
  - url: https://tilt.io
    description: Production
security:
  - apiKeyAuth: []
paths:
  /api/v1/backchannel/scenarios/{id}:
    post:
      tags:
        - Scenarios
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArticleGetRequest'
      responses:
        '200':
          description: Get single article scenario
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleScenarioResponse'
      security:
        - apiKeyAuth: []
components:
  schemas:
    ArticleGetRequest:
      type: object
      properties:
        include_content:
          type: boolean
          default: true
        portfolio_weights:
          type: object
          nullable: true
          additionalProperties:
            type: number
          description: >-
            Portfolio weights keyed by tilt_id or CUSIP. Mixed identifiers are
            allowed; CUSIPs are resolved to tilt_ids server-side.
        aggregate_scenarios:
          type: boolean
          default: false
        seen_image_ids:
          type: array
          nullable: true
          items:
            type: string
        seen_window:
          type: integer
        viewer_user_id:
          type: string
          minLength: 1
    ArticleScenarioResponse:
      type: object
      properties:
        point_id:
          type: string
        headline:
          type: string
        content:
          type: string
          nullable: true
        date:
          type: string
        publication_time:
          type: string
          nullable: true
        tilt_source:
          type: string
          default: ''
        importance_rating:
          type: integer
          default: 0
        importance_rationale:
          type: string
          default: ''
        generated_at:
          type: string
          default: ''
        article_image_url:
          type: string
          nullable: true
        fallback_image_id:
          type: string
          nullable: true
        timeline:
          type: array
          items:
            $ref: '#/components/schemas/TimelineEvent'
          default: []
        scenarios:
          type: array
          items:
            $ref: '#/components/schemas/Scenario'
          default: []
        subject_codes:
          type: array
          items:
            type: object
            additionalProperties:
              nullable: true
          default: []
        subject_codes_original:
          type: array
          items:
            type: string
          default: []
        prediction_markets:
          type: array
          items:
            $ref: '#/components/schemas/PredictionMarket'
          default: []
        score:
          type: number
          nullable: true
        tilt_asset_ids:
          type: array
          items:
            type: string
          default: []
        securities:
          type: array
          items:
            $ref: '#/components/schemas/SecurityRef'
          default: []
          description: >-
            Securities mentioned in the article, mapping each tilt_asset_id to
            its CUSIP when known.
        portfolio_exposure:
          $ref: '#/components/schemas/PortfolioExposure'
        warnings:
          type: array
          nullable: true
          items:
            type: string
      required:
        - point_id
        - headline
        - date
    TimelineEvent:
      type: object
      properties:
        date:
          type: string
        summary:
          type: string
      required:
        - date
        - summary
    Scenario:
      type: object
      properties:
        probability:
          type: integer
          minimum: 0
          maximum: 100
        title:
          type: string
        description:
          type: string
        sub_scenarios:
          type: array
          nullable: true
          items:
            type: object
            additionalProperties:
              nullable: true
          description: Nested sub-scenarios (same shape as Scenario)
        macro_shocks:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/MacroShock'
      required:
        - probability
        - title
        - description
    PredictionMarket:
      type: object
      properties:
        market_id:
          type: string
        question:
          type: string
        relevance:
          type: string
        reasoning:
          type: string
        top_outcomes:
          type: array
          items:
            type: object
            additionalProperties:
              nullable: true
      required:
        - market_id
        - question
        - relevance
        - reasoning
        - top_outcomes
    SecurityRef:
      type: object
      properties:
        tilt_asset_id:
          type: string
        cusip:
          type: string
          nullable: true
          description: CUSIP for this security when SIG can resolve one.
      required:
        - tilt_asset_id
    PortfolioExposure:
      type: object
      nullable: true
      properties:
        mad_pct:
          type: number
        expected_return_pct:
          type: number
        num_leaf_scenarios:
          type: integer
        leaf_details:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/LeafScenarioDetail'
        scenario_level_details:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/ScenarioLevelDetail'
      required:
        - mad_pct
        - expected_return_pct
        - num_leaf_scenarios
    MacroShock:
      type: object
      properties:
        indicator:
          type: string
        impact:
          type: number
      required:
        - indicator
        - impact
    LeafScenarioDetail:
      type: object
      properties:
        path:
          type: array
          items:
            type: string
        title:
          type: string
        joint_probability_pct:
          type: number
        portfolio_return_pct:
          type: number
        abs_portfolio_return_pct:
          type: number
      required:
        - path
        - title
        - joint_probability_pct
        - portfolio_return_pct
        - abs_portfolio_return_pct
    ScenarioLevelDetail:
      type: object
      properties:
        title:
          type: string
        description:
          type: string
        probability_pct:
          type: number
        portfolio_return_mean_pct:
          type: number
        portfolio_return_std_pct:
          type: number
        macro_shocks:
          type: array
          items:
            $ref: '#/components/schemas/MacroShockDistributionDetail'
        sub_scenario_count:
          type: integer
      required:
        - title
        - description
        - probability_pct
        - portfolio_return_mean_pct
        - portfolio_return_std_pct
        - macro_shocks
        - sub_scenario_count
    MacroShockDistributionDetail:
      type: object
      properties:
        indicator:
          type: string
        mean:
          type: number
        std:
          type: number
      required:
        - indicator
        - mean
        - std
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````