---
title: "Macro regime classification"
method: GET
path: "/v1/macro/regimes"
---

# Macro regime classification

`GET /v1/macro/regimes`

## Request

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

Return the current macro regime classification for a country using the canonical SEC API macro overlay.

## Query parameters

- `country` string
- `lookback` string
- `response_mode` 'compact' | 'standard' | 'verbose' | 'full' | 'agent'
- `include` string

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `data` MacroRegime[], required
    - `key` string, required
    - `label` string, required
    - `country` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `drivers` object[], required
      - `key` string, required
      - `label` string, required
      - `category` 'factor' | 'macro' | 'filing_risk' | 'news' | 'valuation' | 'ownership', required
      - `contributionPercent` number, required
      - `explanation` string, required
      - `trace` object, nullable
        - `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
    - `factorImpacts` object[], required
      - `factorKey` string, required
      - `score` number, required
      - `direction` 'tailwind' | 'headwind' | 'neutral', required
      - `rationale` string, required
  - `hasMore` boolean
  - `nextCursor` string, nullable
  - `requestId` string

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