---
title: "Macro coverage status"
method: GET
path: "/v1/macro/status"
---

# Macro coverage status

`GET /v1/macro/status`

## Request

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

Return macro runtime readiness, artifact freshness, source posture, and country support status.

## Query parameters

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

## Response `200`

Successful response

- MacroStatus
  - `object` 'macro_status', required
  - `status` 'ready' | 'degraded' | 'stale' | 'unsupported', required
  - `generatedAt` string, required
  - `artifactGeneratedAt` string, nullable
  - `computedAt` string
  - `statusSource` 'validation_artifacts' | 'runtime_registry_fallback'
  - `countries` object[], required
    - `country` string, required
    - `status` 'ready' | 'degraded' | 'stale' | 'unsupported', required
    - `seriesCount` integer, required
    - `freshCount` integer, required
    - `staleCount` integer, required
    - `sourceErrorCount` integer, required
    - `fallbackCount` integer, required
    - `latestMaterializedAt` string, nullable, required
    - `oldestFreshnessAgeHours` number, nullable, required
    - `topAlerts` string[], required
  - `sources` object[], required
    - `sourceKey` string, required
    - `status` 'ready' | 'degraded' | 'stale' | 'unsupported', required
    - `indicatorCount` integer, required
    - `unexpectedFallbackCount` integer, required
    - `sourceErrorCount` integer, required
    - `artifactStatus` 'available' | 'unavailable'
    - `topAlerts` string[]
  - `alerts` string[], required
  - `methodology` object, required
    - `id` string, required
    - `version` string, required
    - `summary` string, required
  - `sourceRights` object, required
    - `posture` string, required
    - `summary` string, required
  - `indicators` object[]

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