---
title: "Country indicator history"
method: GET
path: "/v1/embed/macro/series/{iso2}/{indicator}"
tags: ["Embed"]
---

# Country indicator history

`GET /v1/embed/macro/series/{iso2}/{indicator}`

## Request

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

Public full-history series and stats for one country indicator.

## Path parameters

- `iso2` string, required
- `indicator` 'inflation-rates' | 'interest-rates' | 'gdp' | 'unemployment-rate' | 'debt-to-gdp' | 'balance-of-trade', required

## Response `200`

Successful response

- EmbedMacroSeries
  - `object` 'embed_macro_series', required
  - `contractVersion` 'v1', required
  - `country` string, required
  - `slug` string, required
  - `name` string, required
  - `indicator` 'inflation-rates' | 'interest-rates' | 'gdp' | 'unemployment-rate' | 'debt-to-gdp' | 'balance-of-trade', required
  - `ticker` string, required
  - `unit` string, 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
  - `asOf` string, required
  - `stats` object, required
    - `min` number, nullable, required
    - `max` number, nullable, required
    - `avg` number, nullable, required
    - `latest` number, nullable, required
    - `previous` number, nullable, required
    - `change` number, nullable, required
  - `observations` object[], required
    - `period` string, required
    - `value` number, nullable, 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)