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

# Read retained forecast status and results

> Requires forecast:read and current source access. Follow next_cursor with the same quantile selection. Reads do not create another prediction run.



## OpenAPI

````yaml /api-reference/forecasting/openapi.json get /api/forecasts/{runId}
openapi: 3.1.0
info:
  title: Mach-1 forecasting API
  version: 2026-10
  description: >-
    Bounded forecasting using the existing prediction engine. Requires
    forecast-scoped credentials. Numerical limits: 4 series, 32768 total history
    buckets, 10000 total future points, 8 drivers per series. Runtime
    normalization additionally checks alignment, timezone, and observed-history
    rules.
servers:
  - url: https://build.aioncx.com
security:
  - forecastKey: []
paths:
  /api/forecasts/{runId}:
    get:
      summary: Read retained forecast status and results
      description: >-
        Requires forecast:read and current source access. Follow next_cursor
        with the same quantile selection. Reads do not create another prediction
        run.
      operationId: getMach1Forecast
      parameters:
        - name: runId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: workspace_id
          in: query
          required: false
          description: >-
            Select a granted workspace. Required when a credential grants
            multiple workspaces.
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 50
        - name: cursor
          in: query
          schema:
            type: string
            maxLength: 2048
        - name: quantiles
          in: query
          description: >-
            Comma-separated supported levels. Default: 0.05,0.5,0.95. Keep the
            same selection across cursor pages.
          schema:
            type: string
            default: 0.05,0.5,0.95
      responses:
        '200':
          description: Saved status and authorized result page
          content:
            application/json:
              schema:
                type: object
                required:
                  - run_id
                  - status
                  - rows
                  - next_cursor
                properties:
                  run_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                  method:
                    type: string
                  method_version:
                    type:
                      - string
                      - 'null'
                  error:
                    type: string
                  rows:
                    type: array
                    items:
                      type: object
                      required:
                        - interval_start
                        - interval_end
                        - predicted_value
                      properties:
                        series_id:
                          type:
                            - string
                            - 'null'
                        dimensions:
                          type: object
                          additionalProperties: true
                        interval_start:
                          type: string
                          format: date-time
                        interval_end:
                          type: string
                          format: date-time
                        predicted_value:
                          type:
                            - number
                            - 'null'
                        lower_bound:
                          type:
                            - number
                            - 'null'
                        upper_bound:
                          type:
                            - number
                            - 'null'
                        point_statistic:
                          type: string
                        tail_assumption:
                          type:
                            - string
                            - 'null'
                        interval_statistic:
                          type: string
                        quantile_space:
                          type:
                            - string
                            - 'null'
                        quantiles:
                          type: array
                          items:
                            type: object
                            required:
                              - level
                              - value
                            properties:
                              level:
                                type: number
                              value:
                                type: number
                  next_cursor:
                    type:
                      - string
                      - 'null'
        '400':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '401':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '403':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '404':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '409':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '413':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '415':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
        '503':
          description: Request refused or service unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                  retryable:
                    type: boolean
components:
  securitySchemes:
    forecastKey:
      type: http
      scheme: bearer
      description: >-
        A scoped Mach-1 atlas_ingest_ key with forecast:submit and/or
        forecast:read. Ingestion scopes alone do not grant forecasting.

````

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