World Bank Countries API
The Countries API from World Bank — 2 operation(s) for countries.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/worldbank-countries-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 2.0.0
title: World Bank Indicators Classifications Countries API
description: 'The World Bank Indicators API provides programmatic access to nearly 16,000 time series development indicators. These indicators include data such as total population, gross domestic product, energy use, poverty rates, health metrics, education statistics, and demographic data across countries and regions. Most data series date back over 50 years. No authentication is required. Supports filtering by date range, country, region, income level, and lending type. Returns data in JSON format with pagination support.
'
contact:
name: World Bank Data Help Desk
url: https://datahelpdesk.worldbank.org
email: data@worldbank.org
license:
name: Creative Commons Attribution 4.0
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://api.worldbank.org/v2
description: World Bank API v2
tags:
- name: Countries
paths:
/country:
get:
summary: List countries
description: 'Returns a list of countries with geographical and economic classification information. Supports filtering by country code, region, income level, and lending type.
'
operationId: listCountries
tags:
- Countries
parameters:
- name: format
in: query
description: Response format
required: false
schema:
type: string
enum:
- json
- xml
- jsonp
default: json
- name: page
in: query
description: Page number for pagination
required: false
schema:
type: integer
default: 1
- name: per_page
in: query
description: Number of records per page (max 1000)
required: false
schema:
type: integer
default: 50
maximum: 1000
- name: region
in: query
description: Filter by region code (e.g., EAS, ECS, LCN, MEA, NAC, SAS, SSF)
required: false
schema:
type: string
- name: incomeLevel
in: query
description: Filter by income level (e.g., HIC, UMC, LMC, LIC)
required: false
schema:
type: string
- name: lendingType
in: query
description: Filter by lending type (e.g., IBD, IDA, IDX, LNX)
required: false
schema:
type: string
responses:
'200':
description: List of countries
content:
application/json:
schema:
type: array
items:
oneOf:
- $ref: '#/components/schemas/PaginationData'
- type: array
items:
$ref: '#/components/schemas/Country'
/country/{country_code}:
get:
summary: Get country details
description: Returns details for a specific country identified by its ISO 3166-1 alpha-2 or alpha-3 code.
operationId: getCountry
tags:
- Countries
parameters:
- name: country_code
in: path
description: ISO 3166-1 country code (2 or 3 characters, e.g., US, USA, CN, CHN)
required: true
schema:
type: string
- name: format
in: query
description: Response format
required: false
schema:
type: string
enum:
- json
- xml
default: json
responses:
'200':
description: Country details
content:
application/json:
schema:
type: array
items:
oneOf:
- $ref: '#/components/schemas/PaginationData'
- type: array
items:
$ref: '#/components/schemas/CountryDetail'
components:
schemas:
PaginationData:
type: object
description: Pagination metadata returned as the first element of the response array
properties:
page:
type: integer
description: Current page number
example: 1
pages:
type: integer
description: Total number of pages
example: 10
per_page:
type: integer
description: Records per page
example: 50
total:
type: integer
description: Total number of records
example: 500
sourceid:
type:
- string
- 'null'
description: Source identifier
example: '2'
sourcename:
type:
- string
- 'null'
description: Source name
example: World Development Indicators
lastupdated:
type:
- string
- 'null'
description: Date of last data update
example: '2024-06-28'
ClassificationRef:
type: object
description: Reference to a World Bank classification category
properties:
id:
type: string
description: Classification code
example: NAC
iso2code:
type: string
description: ISO 2-character code
example: XU
value:
type: string
description: Human-readable classification name
example: North America
Country:
type: object
description: World Bank country classification data
properties:
id:
type: string
description: ISO 3166-1 alpha-3 country code
example: USA
iso2Code:
type: string
description: ISO 3166-1 alpha-2 country code
example: US
name:
type: string
description: Country name
example: United States
region:
$ref: '#/components/schemas/ClassificationRef'
adminregion:
$ref: '#/components/schemas/ClassificationRef'
incomeLevel:
$ref: '#/components/schemas/ClassificationRef'
lendingType:
$ref: '#/components/schemas/ClassificationRef'
capitalCity:
type: string
description: Capital city name
example: Washington D.C.
longitude:
type: string
description: Country centroid longitude
example: '-95.7129'
latitude:
type: string
description: Country centroid latitude
example: '37.0902'
CountryDetail:
allOf:
- $ref: '#/components/schemas/Country'