---
title: "Company macro exposure"
method: GET
path: "/v1/companies/macro-exposure"
---

# Company macro exposure

`GET /v1/companies/macro-exposure`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/companies/macro-exposure`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use this route to inspect a company's modelled macro sensitivities, weighted by available disclosed geographic revenue segments. `coveragePercent`, confidence, source context, and the selected reporting period explain how much of the issuer's revenue could be mapped; a low-coverage result is not a statement that the issuer has no foreign exposure. The returned betas and directions are an exposure snapshot, not a forecast or investment recommendation. See [statements reference](/api-reference/statements) and [freshness and source evidence](/freshness-and-trust).

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string
- `country` string
- `lookback` string
- `period` 'annual' | 'quarterly'

## Response `200`

Successful response

- CompanyMacroExposure
  - `object` 'company_macro_exposure', required
  - `ticker` string, required
  - `country` string, required
  - `asOf` string, required
  - `lookback` string, nullable, required
  - `exposures` object[], required
    - `indicatorKey` string, required
    - `label` string, required
    - `indicatorType` 'growth' | 'inflation' | 'labor' | 'rates' | 'trade' | 'fiscal' | 'housing' | 'sentiment' | 'money' | 'other', required
    - `beta` number, nullable, required
    - `rSquared` number, nullable, required
    - `sensitivityRank` integer, nullable, required
    - `direction` 'positive' | 'negative' | 'neutral', nullable, required
    - `confidence` 'high' | 'medium' | 'low', nullable, required
  - `summaryMd` string, nullable, required
  - `provenance` object, required
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `accessionNumber` string, nullable, required
    - `filingUrl` string, uri, nullable, 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, required
    - `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)