---
title: "Economic statistics by country (World Bank + OECD)"
method: GET
path: "/macro/economics"
tags: ["macro"]
---

# Economic statistics by country (World Bank + OECD)

`GET /macro/economics`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/macro/economics`
- Auth: HTTP bearer

Official economic statistics as published by the World Bank (World Development Indicators, annual, about 217 economies) and the OECD (monthly consumer price index, unemployment rate, industrial production and retail volume, about 40 economies).

No parameters: the indicator catalogue with coverage counts. `country` (ISO-3 or ISO-2): the newest value of every series for that economy. `indicator`: the newest value for every economy that has it. `country` + `indicator`: that series' history, oldest first, with the series row under `meta.series`.

Every row names its source, cadence, unit, licence and the credit line the licence requires (`attribution`); reproduce it when you quote a figure. `yoy` is the one Kresmion calculation: % change against the same period a year earlier for a level series, change in percentage points for a rate series (`yoy_unit`).

## Query parameters

- `country` string, nullable: ISO-3 (FRA) or ISO-2 (FR) economy code.
- `indicator` string, nullable: Indicator key, e.g. gdp_growth, cpi_index, unemployment_monthly. Omit for every indicator.
- `limit` integer: History length in periods, `country` + `indicator` only (default 120).

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kresmion/apis/kresmion-api.md) · [All operations](https://skmtc.dev/kresmion/apis/kresmion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kresmion/apis/kresmion-api/revisions/a94962dddccb?raw)