> ## Documentation Index > Fetch the complete documentation index at: https://quantura.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get forecast result ## OpenAPI ````yaml /docs/api/openapi.json get /v1/ensemble-forecasts/{forecast_id} openapi: 3.1.0 info: title: Quantura API version: 1.0.0 description: >- Search markets and public datasets, download historical observations, create forecasts and inspect screener quantiles. contact: name: Quantura url: https://quantura.studio/contact license: name: Quantura API Terms url: https://quantura.studio/terms servers: - url: https://quantura.studio/api security: - bearerAuth: [] - clerkOAuth: - openid - profile - email tags: - name: Access - name: Forecast - name: Screener - name: Search - name: Download - name: Scout paths: /v1/ensemble-forecasts/{forecast_id}: servers: - url: https://quantura.studio/api get: tags: - Forecast summary: Get forecast result operationId: getEnsembleForecast parameters: - name: forecast_id in: path required: true description: Forecast id or unique slug. schema: type: string responses: '200': description: Queued/running progress or completed ensemble predictions. content: application/json: schema: $ref: '#/components/schemas/EnsembleForecastEnvelope' example: data: forecast_id: ens_01JEXAMPLE7M6N status: completed progress: completed_models: 1 total_models: 1 current_model: null status_url: /api/v1/ensemble-forecasts/ens_01JEXAMPLE7M6N result_url: /api/v1/ensemble-forecasts/ens_01JEXAMPLE7M6N quantiles: - 0.1 - 0.5 - 0.9 predictions: - timestamp: '2026-09-21T00:00:00Z' quantiles: '0.1': 98 '0.5': 100 '0.9': 102 meta: api_version: v1 '401': description: Authentication failed content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string format: uuid '403': description: Scope, plan, or workspace authorization denied content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string format: uuid '404': description: Forecast job not found. '429': description: Rate limit exceeded content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string format: uuid security: - bearerAuth: [] - clerkOAuth: - openid - profile - email components: schemas: EnsembleForecastEnvelope: type: object required: - data - meta properties: data: type: object required: - forecast_id - status properties: forecast_id: type: string status: type: string enum: - queued - running - completed - failed progress: type: - object - 'null' predictions: type: array items: $ref: '#/components/schemas/EnsemblePrediction' historical_validation: $ref: '#/components/schemas/HistoricalForecastValidation' effective_weights_by_quantile: type: object status_url: type: string result_url: type: string provenance: $ref: '#/components/schemas/ForecastTimestampReceipt' meta: type: object properties: api_version: const: v1 EnsemblePrediction: type: object required: - timestamp - quantiles properties: timestamp: type: string format: date-time quantiles: type: object additionalProperties: type: number description: Canonical decimal quantile string to final ensemble value. HistoricalForecastValidation: type: object required: - policy - method - status - metrics description: >- Forecast jobs include one chronological holdout of up to 30 existing observations when enough history is available. No future observations are needed. These scores describe historical validation of the selected models, separate from the requested future predictions. A failed or insufficient holdout does not fail the forecast. properties: policy: const: chronological_holdout_v1 method: const: chronological_holdout status: type: string enum: - completed - insufficient_history - no_matching_outcomes - failed training_rows: type: integer minimum: 2 holdout_rows: type: integer minimum: 1 maximum: 30 training_end_at: type: string format: date-time validation_start_at: type: string format: date-time validation_end_at: type: string format: date-time requested_models: type: array items: type: string effective_weights_by_quantile: type: object metrics: type: - object - 'null' properties: count: type: integer minimum: 0 point_count: type: integer minimum: 0 mae: type: - number - 'null' minimum: 0 rmse: type: - number - 'null' minimum: 0 smape: type: - number - 'null' minimum: 0 maximum: 2 description: >- Ratio, not percent; the UI multiplies by 100. Zero/zero contributes zero. average_wql: type: - number - 'null' minimum: 0 description: >- Mean twice-pinball loss divided by total absolute actual values; null for all-zero actuals. example: policy: chronological_holdout_v1 method: chronological_holdout status: completed training_rows: 493 holdout_rows: 7 training_end_at: '2026-09-08T20:00:00Z' validation_start_at: '2026-09-09T20:00:00Z' validation_end_at: '2026-09-17T20:00:00Z' metrics: count: 7 point_count: 7 mae: 1.25 rmse: 1.6 smape: 0.012 average_wql: 0.018 ForecastTimestampReceipt: type: - object - 'null' properties: provider: const: vbase schema_version: const: quantura_forecast_proof_v1 status: type: string enum: - pending - stamping - stamped - unavailable content_cid: type: - string - 'null' pattern: ^0x[0-9a-f]{64}$ receipt: type: - object - 'null' properties: object_cid: type: string pattern: ^0x[0-9a-f]{64}$ set_cid: type: string pattern: ^0x[0-9a-f]{64}$ transaction_hash: type: string pattern: ^0x[0-9a-f]{64}$ user_address: type: - string - 'null' user_label: type: string description: >- Account display name returned during recovery, not a blockchain address. chain_id: type: integer timestamp: type: string format: date-time error_code: type: - string - 'null' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Clerk personal API key or legacy Quantura key clerkOAuth: type: oauth2 description: >- Clerk authorization code with PKCE S256. Pass resource=https://quantura.studio on authorization and token requests. Paid Pro, enterprise or verified administrator API access is required. flows: authorizationCode: authorizationUrl: https://clerk.quantura.studio/oauth/authorize tokenUrl: https://clerk.quantura.studio/oauth/token refreshUrl: https://clerk.quantura.studio/oauth/token scopes: openid: Identify the Quantura account profile: Resolve the account profile email: Verify account email offline_access: Refresh access after expiry ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.