---
title: "Footnote intelligence query"
method: POST
path: "/v1/intelligence/footnotes/query"
---

# Footnote intelligence query

`POST /v1/intelligence/footnotes/query`

## Request

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

Return a structured filing-footnote investigation bundle. Single-ticker latest-only requests return a footnote_intelligence_result; multi-ticker or date-range requests return a footnote_intelligence_collection.

## Request body

- FootnoteIntelligenceRequest
  - `ticker` string
  - `tickers` string[]
  - `cik` string
  - `form` string, required
  - `topics` string[], required
  - `query` string, nullable
  - `dateFrom` string
  - `dateTo` string
  - `window` string
  - `filingsPerTicker` integer

## Response `200`

Successful response

- union
  - FootnoteIntelligenceResult
    - `dataAsOf` string
    - `freshnessStatus` string
    - `methodologyVersion` string
    - `materializationVersion` string
    - `object` 'footnote_intelligence_result', required
    - `id` string, required
    - `asOf` string, required
    - `symbol` string, nullable
    - `cik` string, nullable
    - `form` string, required
    - `query` string, nullable
    - `filing` object, nullable, required
      - `object` 'filing', required
      - `id` string, required
      - `createdAt` string, required
      - `livemode` boolean, required
      - `entityId` string, required
      - `ticker` string, nullable
      - `companyName` string
      - `form` string, required
      - `filingDate` string, required
      - `reportDate` string, nullable
      - `accessionNumber` string, required
      - `title` string, required
      - `summaryMd` string
      - `snippet` string
      - `provenance` object, required
        - `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
      - `validation` object
        - `status` 'validated' | 'unvalidated' | 'degraded', required
        - `confidence` 'high' | 'medium' | 'low', nullable
        - `validatedAt` string, nullable
        - `validationPipeline` string, nullable
        - `exceptions` string[], required
    - `topics` object[], required
      - `key` 'lease' | 'tax' | 'revenue' | 'debt_covenant' | 'segment' | 'going_concern' | 'litigation' | 'customer_concentration', required
      - `label` string, required
      - `snippets` string[], required
      - `traces` object[], required
        - `id` string, required
        - `kind` 'filing_fact' | 'filing_excerpt' | 'derived_metric' | 'source_record', required
        - `status` 'supported' | 'degraded' | 'unavailable', required
        - `href` string, required
        - `page` integer, nullable
        - `region` object, nullable
          - `status` 'supported' | 'degraded' | 'unavailable', required
          - `kind` 'inline_xbrl_fact' | 'html_text_range', nullable
          - `startOffset` integer, nullable
          - `endOffset` integer, nullable
          - `snippet` string, nullable
          - `viewerFragment` string, nullable
    - `summaryMd` string, 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
  - FootnoteIntelligenceCollection
    - `dataAsOf` string
    - `freshnessStatus` string
    - `methodologyVersion` string
    - `materializationVersion` string
    - `object` 'footnote_intelligence_collection', required
    - `id` string, required
    - `asOf` string, required
    - `form` string, required
    - `query` string, nullable
    - `scope` object, required
      - `tickerCount` integer, required
      - `requestedTopics` string[], required
      - `dateFrom` string, nullable
      - `dateTo` string, nullable
      - `window` string, nullable
      - `filingsPerTicker` integer, required
      - `filingBudget` integer, required
      - `filingsRendered` integer, required
      - `concurrency` integer, required
    - `tickers` object[], required
      - `object` 'footnote_ticker_result', required
      - `symbol` string, nullable
      - `cik` string, nullable
      - `form` string, required
      - `filingCount` integer, required
      - `results` object[], required
        - `object` 'footnote_filing_result', required
        - `symbol` string, nullable
        - `cik` string, nullable
        - `form` string, required
        - `accessionNumber` string, nullable, required
        - `filingDate` string, nullable
        - `filingUrl` string, nullable
        - `filing` object, nullable, required
          - `object` 'filing', required
          - `id` string, required
          - `createdAt` string, required
          - `livemode` boolean, required
          - `entityId` string, required
          - `ticker` string, nullable
          - `companyName` string
          - `form` string, required
          - `filingDate` string, required
          - `reportDate` string, nullable
          - `accessionNumber` string, required
          - `title` string, required
          - `summaryMd` string
          - `snippet` string
          - `provenance` object, required
            - `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
          - `validation` object
            - `status` 'validated' | 'unvalidated' | 'degraded', required
            - `confidence` 'high' | 'medium' | 'low', nullable
            - `validatedAt` string, nullable
            - `validationPipeline` string, nullable
            - `exceptions` string[], required
        - `topics` object[], required
          - `key` 'lease' | 'tax' | 'revenue' | 'debt_covenant' | 'segment' | 'going_concern' | 'litigation' | 'customer_concentration', required
          - `label` string, required
          - `snippets` string[], required
          - `traces` object[], required
            - `id` string, required
            - `kind` 'filing_fact' | 'filing_excerpt' | 'derived_metric' | 'source_record', required
            - `status` 'supported' | 'degraded' | 'unavailable', required
            - `href` string, required
            - `page` integer, nullable
            - `region` object, nullable
              - …
        - `summaryMd` string, required
        - `freshness` object
          - `status` 'fresh' | 'stale' | 'degraded' | 'unknown', required
          - `asOf` string, required
          - `sourcePublishedAt` string, nullable
          - `lagMs` integer, nullable
        - `materialization` object
          - `parserVersion` string, required
          - `materializationVersion` string, required
        - `degradedState` object, nullable
          - `code` string, required
          - `message` string, required
          - `retryable` boolean, required
          - `missingCapabilities` string[], required
          - `fallbackUsed` string[], required
      - `error` object, nullable
        - `code` string, required
        - `message` string, required
    - `summaryMd` string, 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

- `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)