---
title: "Country macro overview"
method: GET
path: "/v1/macro/overview"
---

# Country macro overview

`GET /v1/macro/overview`

## Request

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

Return a one-call country macro dashboard: headline indicators with latest/previous/change/direction and next release, the current regime, upcoming releases, and the sovereign credit rating.

## Query parameters

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

## Response `200`

Successful response

- MacroOverview
  - `object` 'macro_overview', required
  - `country` string, required
  - `asOf` string, required
  - `indicators` object[], required
    - `indicatorKey` string, required
    - `label` string, required
    - `indicatorType` 'growth' | 'inflation' | 'labor' | 'rates' | 'trade' | 'fiscal' | 'housing' | 'sentiment' | 'money' | 'other', required
    - `frequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'annual', nullable, required
    - `unit` string, nullable, required
    - `latestValue` number, nullable, required
    - `latestPeriod` string, nullable, required
    - `previousValue` number, nullable, required
    - `change` number, nullable, required
    - `changePct` number, nullable, required
    - `direction` 'up' | 'down' | 'flat', nullable, required
    - `nextReleaseAt` string, nullable, required
    - `comparabilityNote` string, nullable, required
  - `regime` object, required
    - `label` string, nullable, required
    - `growthDirection` 'accelerating' | 'decelerating' | 'flat', nullable, required
    - `inflationDirection` 'accelerating' | 'decelerating' | 'flat', nullable, required
    - `summaryMd` string, nullable, required
  - `upcomingReleases` object[], required
    - `indicatorKey` string, required
    - `label` string, required
    - `releaseAt` string, required
  - `creditRating` object, nullable, required
    - `agency` string, nullable, required
    - `rating` string, nullable, required
    - `outlook` 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)