---
title: "Macroeconomic indicators for African and emerging markets."
method: GET
path: "/v1/macro"
---

# Macroeconomic indicators for African and emerging markets.

`GET /v1/macro`

## Request

- Base URL: `https://api.certvas.com`
- URL: `https://api.certvas.com/v1/macro`
- Auth: API key in header `X-API-Key`

Two modes. With `series` or `as_of`: point-in-time series (FX, CPI), returning the latest vintage known at `as_of` with no look-ahead. Otherwise: annual World Bank indicators by `country` and `indicator`. Attribution and notice conditions travel with the data and are stated per source in the public licence register.

## Query parameters

- `country` string
- `indicator` string
- `series` string
- `series_type` string
- `frequency` string
- `as_of` string, date
- `from` string, date
- `to` string, date
- `limit` integer

## Response `200`

Macro observations.

- object

## Other responses

- `400`: A parameter is malformed or missing; the body names it.
- `401`: Missing or invalid API key.
- `402`: A sample-tier key asked for more than the sample tier serves: more rows than its cap, or a lookup in the paid crosswalk. The body and the X-Upgrade-URL header carry the upgrade link. Omit `limit` for the free preview.
- `429`: Rate limited: the per-minute burst limit or the monthly cap was reached.
- `503`: The key store is temporarily unavailable; retry.

---

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