---
title: "Intelligence query result"
method: GET
path: "/v1/intelligence/query/{jobId}"
---

# Intelligence query result

`GET /v1/intelligence/query/{jobId}`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/intelligence/query/{jobId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Poll an async intelligence workload until the final traced result is ready.

## Response `200`

Completed intelligence query result

- IntelligenceQueryResponse
  - `dataAsOf` string
  - `freshnessStatus` string
  - `methodologyVersion` string
  - `materializationVersion` string
  - `object` 'intelligence_query_result', required
  - `intent` 'macro_conditioned_decomposition' | 'return_decomposition' | 'factor_neutralization' | 'factor_rotation' | 'regime_screen' | 'portfolio_optimization' | 'portfolio_stress_test' | 'country_regime_report' | 'manager_style_drift' | 'ownership_change' | 'insider_monitor' | 'insider_tracking' | 'filing_footnote_investigation' | 'earnings_preview' | 'why_did_it_move', required
  - `intentConfidence` number, required
  - `scope` object, required
    - `target` 'security' | 'watchlist' | 'portfolio' | 'country' | 'manager', required
    - `entityCount` integer, required
    - `countryCount` integer, required
    - `portfolioHoldings` integer, required
    - `lookback` string, nullable
  - `requiredInputs` string[], required
  - `narrowingHints` string[], required
  - `executionClass` 'hot_sync' | 'standard_sync' | 'async', required
  - `planVersion` string, required
  - `queryPlan` object, required
    - `intent` 'macro_conditioned_decomposition' | 'return_decomposition' | 'factor_neutralization' | 'factor_rotation' | 'regime_screen' | 'portfolio_optimization' | 'portfolio_stress_test' | 'country_regime_report' | 'manager_style_drift' | 'ownership_change' | 'insider_monitor' | 'insider_tracking' | 'filing_footnote_investigation' | 'earnings_preview' | 'why_did_it_move', required
    - `intentConfidence` number, required
    - `scope` object, required
      - `target` 'security' | 'watchlist' | 'portfolio' | 'country' | 'manager', required
      - `entityCount` integer, required
      - `countryCount` integer, required
      - `portfolioHoldings` integer, required
      - `lookback` string, nullable
    - `requiredInputs` string[], required
    - `narrowingHints` string[], required
    - `executionClass` 'hot_sync' | 'standard_sync' | 'async', required
    - `planVersion` string, required
  - `queryPlanManifest` object, required
    - `object` 'query_plan_manifest', required
    - `id` string, required
    - `intent` 'macro_conditioned_decomposition' | 'return_decomposition' | 'factor_neutralization' | 'factor_rotation' | 'regime_screen' | 'portfolio_optimization' | 'portfolio_stress_test' | 'country_regime_report' | 'manager_style_drift' | 'ownership_change' | 'insider_monitor' | 'insider_tracking' | 'filing_footnote_investigation' | 'earnings_preview' | 'why_did_it_move', required
    - `intentConfidence` number, required
    - `scope` object, required
      - `target` 'security' | 'watchlist' | 'portfolio' | 'country' | 'manager', required
      - `entityCount` integer, required
      - `countryCount` integer, required
      - `portfolioHoldings` integer, required
      - `lookback` string, nullable
    - `requiredInputs` string[], required
    - `narrowingHints` string[], required
    - `executionClass` 'hot_sync' | 'standard_sync' | 'async', required
    - `planVersion` string, required
    - `slots` object, required
      - `actions` string[], required
      - `subjects` string[], required
      - `contexts` string[], required
      - `entitySymbol` string, nullable
      - `country` string, nullable
      - `managerCik` string, nullable
      - `lookback` string, nullable
    - `validationState` 'ready' | 'needs_inputs', required
    - `missingInputs` string[], required
    - `matchedSignals` string[], required
  - `answerMd` string, nullable
  - `data` object, required
  - `tracepack` string[], required
  - `sources` object[], required
    - `kind` string, required
    - `key` string, nullable
    - `label` string, nullable
  - `latencyMs` integer, required
  - `cacheStatus` 'hit' | 'miss' | 'stale_revalidated' | 'bypass', required
  - `requestId` string
  - `traceparent` string
  - `responseMode` 'compact' | 'standard' | 'verbose'
  - `provenance` object
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `accessionNumber` string, nullable, required
    - `filingUrl` string, uri, required
    - `acceptedAt` string, nullable
    - `retrievedAt` string, required
    - `parserVersion` string, required
  - `freshness` object
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
    - `synthetic` boolean
  - `materialization` object
    - `parserVersion` string, required
    - `materializationVersion` string, required
  - `sourceRights` object
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
    - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
    - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
    - `reviewOwner` string, nullable
    - `reviewedAt` string, nullable
    - `restrictions` string[], required
    - `notes` string, nullable
  - `methodology` object
    - `id` string, required
    - `version` string, required
    - `summary` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `launchState` 'experimental' | 'beta' | 'ga', required
    - `inputs` string[], required
    - `validation` object
  - `revision` object
    - `sourcePublishedAt` string, nullable
    - `retrievedAt` string, required
    - `vintageId` string, nullable
    - `revisedFrom` string, nullable
  - `degradedState` object, nullable
    - `code` string, required
    - `message` string, required
    - `retryable` boolean, required
    - `missingCapabilities` string[], required
    - `fallbackUsed` string[], required

## Other responses

- `202`: Still-running intelligence query job
- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)