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.
openapi: 3.2.0
info:
version: 2.0.0
title: World Bank Indicators Regions API
description: The World Bank Indicators API provides programmatic access to nearly 16,000 time series development indicators.
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: Regions
paths:
/region:
get:
summary: List regions
description: Returns a list of World Bank regions.
operationId: listRegions
tags:
- Regions
parameters:
- name: format
in: query
description: Response format
required: false
schema:
type: string
enum:
- json
- xml
default: json
- name: page
in: query
description: Page number
required: false
schema:
type: integer
default: 1
- name: per_page
in: query
description: Records per page
required: false
schema:
type: integer
default: 50
responses:
'200':
description: List of regions
content:
application/json:
schema:
type: array
items:
oneOf:
- $ref: '#/components/schemas/PaginationData'
- type: array
items:
$ref: '#/components/schemas/Region'
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'
Region:
type: object
description: World Bank geographic region
properties:
id:
type: string
description: Region code
example: EAS
iso2code:
type: string
description: ISO 2-character region code
example: Z4
name:
type: string
description: Region name
example: East Asia & Pacific