---
title: "Country macro indicators"
method: GET
path: "/v1/embed/macro/countries/{iso2}"
tags: ["Embed"]
---

# Country macro indicators

`GET /v1/embed/macro/countries/{iso2}`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/embed/macro/countries/{iso2}`
- Auth: none required

Public latest values across the macro-map indicators for one country.

## Path parameters

- `iso2` string, required

## Response `200`

Successful response

- EmbedMacroCountry
  - `object` 'embed_macro_country', required
  - `contractVersion` 'v1', required
  - `country` string, required
  - `slug` string, required
  - `name` string, required
  - `asOf` string, required
  - `indicators` EmbedMacroCountryLatest[], required
    - `indicator` 'inflation-rates' | 'interest-rates' | 'gdp' | 'unemployment-rate' | 'debt-to-gdp' | 'balance-of-trade', required
    - `ticker` string, required
    - `label` string, required
    - `unit` string, required
    - `latestValue` number, nullable, required
    - `previousValue` number, nullable, required
    - `latestPeriod` string, nullable, required
    - `frequency` 'annual' | 'monthly' | 'quarterly', required
    - `source` 'World Bank' | 'International Monetary Fund' | 'Bank for International Settlements' | 'International Labour Organization' | 'Organisation for Economic Co-operation and Development' | 'U.S. Energy Information Administration' | 'National statistics office' | 'Central bank', required
  - `quotes` EmbedMacroCountryQuote[], required
    - `id` 'cpi-yoy' | 'policy-rate' | 'gdp-usd' | 'unemployment-rate' | 'govt-debt-gdp' | 'trade-balance' | 'gdp-growth-rate' | 'core-inflation-yoy' | 'retail-sales-yoy' | 'corporate-tax-rate' | 'personal-tax-top-rate' | 'business-confidence' | 'consumer-confidence' | 'food-inflation-yoy' | 'housing-index' | 'mean-temperature' | 'crude-oil-production' | 'gdp-growth-annual' | 'gdp-constant-prices' | 'gdp-per-capita' | 'gdp-per-capita-ppp' | 'gross-national-product' | 'employment-rate' | 'labour-force-participation' | 'youth-unemployment-rate' | 'consumer-price-index' | 'hospital-beds' | 'life-expectancy' | 'broad-money-gdp' | 'fx-reserves' | 'exports' | 'imports' | 'current-account' | 'current-account-gdp' | 'government-budget' | 'government-spending' | 'fiscal-expenditure' | 'industrial-production-growth' | 'consumer-spending' | 'precipitation' | 'co2-per-capita' | 'producer-prices-wpi', required
    - `label` string, required
    - `unit` string, required
    - `latestValue` number, nullable, required
    - `previousValue` number, nullable, required
    - `latestPeriod` string, nullable, required
    - `frequency` 'annual' | 'monthly' | 'quarterly', required
    - `source` 'World Bank' | 'International Monetary Fund' | 'Bank for International Settlements' | 'International Labour Organization' | 'Organisation for Economic Co-operation and Development' | 'U.S. Energy Information Administration' | 'National statistics office' | 'Central bank', required
    - `periodLabel` string, nullable, required
    - `comparabilityNote` string, nullable, required: Why this country's value cannot be placed on one axis with another country's value for the same quote id, or null when it can. Non-null means the series must be withheld from cross-country charts, rankings and heat maps — annotating a single country's number is not sufficient.

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