▣ FINANCE · STANDARD DATA

Retrieve World Bank Public Data API

What it does

World Bank Indicators lets you fetch a single World Bank indicator series for a country over a date range. Send an indicator code in the path, and optionally country, date, and per_page as query parameters.

Use it when you need authoritative macroeconomic or development data in your app, dashboard, or analysis pipeline. The default country is US, country accepts a 2- to 3-character code, date can be a range like 2015:2024, and per_page controls how many records come back in one response.

The response schema is flexible, so you should treat the payload as a structured World Bank series response rather than a fixed object with named fields. That makes it suitable for workflows where you pass the data through to reporting, storage, or downstream transformation without guessing at undocumented properties.

World Bank Indicators is a good fit for GDP, population, inflation, education, and other country-level metrics where you need a standard external data source and a simple lookup by indicator code.

GET

World Bank indicator series

http://localhost:8080/dosvak/world-bank-indicator-series/:indicator

QUICKSTART

GUIDE

Quickstart

Fetch World Bank data for one indicator, using the required indicator in the path and a simple country filter.

curl -X GET "http://localhost:8080/dosvak/world-bank-indicator-series/:indicator" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema does not declare any specific top-level fields, so the response shape may vary.

{
  "country": "US",
  "indicator": "SP.POP.TOTL",
  "date": null,
  "snapshot_updated_at": "2026-07-28T13:06:29.104470Z",
  "count": 16,
  "results": [
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2025",
      "value": 341784857,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2024",
      "value": 340003797,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2023",
      "value": 336755052,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2022",
      "value": 333996304,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2021",
      "value": 332100166,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2020",
      "value": 331578104,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2019",
      "value": 330226227,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2018",
      "value": 328529577,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2017",
      "value": 326608609,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2016",
      "value": 324353340,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2015",
      "value": 321815121,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2014",
      "value": 319257560,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2013",
      "value": 316726282,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2012",
      "value": 314339099,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2011",
      "value": 311839461,
      "unit": ""
    },
    {
      "country": "US",
      "country_name": "United States",
      "indicator": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "date": "2010",
      "value": 309378227,
      "unit": ""
    }
  ],
  "attribution": [
    {
      "source": "World Bank",
      "dataset": "World Development Indicators and related open datasets",
      "license": "World Bank Open Data terms",
      "url": "https://datahelpdesk.worldbank.org/knowledgebase/articles/902061-clause-in-terms-and-conditions-regarding-source",
      "notice": "Contains World Bank open data. Downstream usage should preserve required attribution."
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves a World Bank indicator series for a specific indicator, with optional filters for country, date range, and page size. The request identifies the indicator in the path and returns a JSON object; the response schema does not define fixed fields.

Path Parameter(s)

Attribute	Type	Mandatory	Description
indicator	String	Yes	World Bank indicator code, minimum length 3.

Query Parameter(s)

Attribute	Type	Mandatory	Description
date	String	No	Date filter as a string; example format: `2015:2024`.
country	String	No	Country code, 2 to 3 characters. Default: `US`.
per_page	Integer	No	Number of results per page. Default: `100`; minimum `1`, maximum `1000`.

Response

Returns a JSON object. The output schema does not declare fixed top-level fields and allows additional properties, so the exact response shape is not captured in the schema.

Path parameters

Name

Type

Description

indicatorREQUIRED

string

—

Query parameters

Name

Type

Description

dateOPTIONAL

string

—

countryOPTIONAL

string

—

DEFAULT US

per_pageOPTIONAL

integer

—

DEFAULT 100

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.