docs / worldbank

World Bank

Global economic indicators by country.

base /worldbank/v17 endpoints

post/worldbank/v1/indicator2 credits

time-series for one+ indicators (code or shortcut) across one+ countries/all; date/mrv/mrnev, rank

Parameter	Required
country	required
indicator	required
date	optional
mrv	optional
mrnev	optional
drop_nulls	optional
rank	optional
per_page	optional
max_pages	optional
frequency	optional
gapfill	optional

Try in playground →

post/worldbank/v1/country1 credit

country metadata for codes/all or filtered by region/income_level/lending_type

Parameter	Required
country	required
region	optional
income_level	optional
lending_type	optional
exclude_aggregates	optional
all	optional

Try in playground →

post/worldbank/v1/search_indicators1 credit

local keyword search over the indicator catalog (WDI default; full=all sources)

Parameter	Required
query	required
source	optional
full	optional
topic	optional
limit	optional

Try in playground →

post/worldbank/v1/indicator_metadata1 credit

definition/source/organization/topics for one+ indicator codes/aliases

Parameter	Required
indicator	required

Try in playground →

post/worldbank/v1/country_profile2 credits

one-call headline snapshot (most-recent ~10 key metrics) for one+ countries

Parameter	Required
country	required
metrics	optional

Try in playground →

post/worldbank/v1/shortcuts1 credit

list the metric->indicator-code map, or metric=<key>&country=<code> to fetch directly

Parameter	Required
metric	optional
country	optional
date	optional
mrv	optional
mrnev	optional

Try in playground →

post/worldbank/v1/reference1 credit

reference lists: regions | income_levels | lending_types | sources | topics

Parameter	Required
kind	required

Try in playground →

Example request · indicator

curl -X POST https://api.reefapi.com/worldbank/v1/indicator \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"country":"US","indicator":"NY.GDP.MKTP.CD","date":"2015:2022"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}