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

# Intelligence

> Research-ready intelligence bundles for issuers, portfolios, macro exposure, filings, and watchlists.

Use Intelligence endpoints to retrieve research-ready bundles for companies, securities, portfolios, countries, watchlists, earnings previews, macro exposure, and filing-footnote investigations, or to run traced allocator workloads asynchronously.

<Note>
  The sidebar labels inside this family are the literal calls you make over HTTP. Descriptions stay in the body so the navigation stays sharp and scannable.
</Note>

## Operations in this family

<CardGroup cols={2}>
  <Card title="GET /v1/intelligence/company" href="/api-reference/intelligence/get-v1-intelligence-company">Return a one-call company bundle spanning market, filings, ownership, macro, factor, and risk context</Card>
  <Card title="POST /v1/intelligence/country-report" href="/api-reference/intelligence/post-v1-intelligence-country-report">Return a country intelligence bundle covering the prior period's macro path, likely drivers, and forward view</Card>
  <Card title="GET /v1/intelligence/coverage" href="/api-reference/intelligence/get-v1-intelligence-coverage">AI coverage-report composer: single-issuer rollup over the persisted filings-intelligence stores (tagged events, guidance, transcripts, footnote newness).</Card>
  <Card title="GET /v1/intelligence/earnings-preview" href="/api-reference/intelligence/get-v1-intelligence-earnings-preview">Return an earnings preview bundle with estimates, drivers, risks, and traceable supporting context</Card>
  <Card title="POST /v1/intelligence/footnotes/query" href="/api-reference/intelligence/post-v1-intelligence-footnotes-query">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.</Card>
  <Card title="POST /v1/intelligence/macro-exposure" href="/api-reference/intelligence/post-v1-intelligence-macro-exposure">Return revenue-weighted macro sensitivities for a portfolio: geographic revenue segments crossed with the country macro plane, with per-holding contributions and a coverage percentage</Card>
  <Card title="POST /v1/intelligence/portfolio" href="/api-reference/intelligence/post-v1-intelligence-portfolio">Return a one-call portfolio intelligence bundle with exposures, stress scenarios, events, and hedge ideas</Card>
  <Card title="POST /v1/intelligence/query" href="/api-reference/intelligence/post-v1-intelligence-query">Compile an allocator prompt into a deterministic one-call intelligence workload with compact traced output</Card>
  <Card title="GET /v1/intelligence/query/{jobId}" href="/api-reference/intelligence/get-v1-intelligence-query-jobId">Poll an async intelligence workload until the final traced result is ready</Card>
  <Card title="GET /v1/intelligence/security" href="/api-reference/intelligence/get-v1-intelligence-security">Return a one-call security bundle with snapshot, catalysts, filings, and factor context</Card>
  <Card title="POST /v1/intelligence/watchlist" href="/api-reference/intelligence/post-v1-intelligence-watchlist">Return a watchlist briefing bundle with movers, catalysts, factor context, and regime overlays</Card>
</CardGroup>