API: Country Queries
About Country Queries
The following information is available for the countries and economies listed in the World Bank API:
- 3 letter ISO 3166-1 alpha-3 code code
- 2 letter ISO 3166-1 alpha-2 code code
- Name
- Region id
- Region Name
- Income Level
- Lending Type
- Capital City
- Longitude
- Latitude
Note: The World Bank follows the ISO 3 letter and 2 letter codes to represent most of the countries, with the following exceptions
3 letter Code differences: Andorra, Congo, Dem. Rep., Isle of Man, Romania, Timor-Leste, West Bank and Gaza
2 letter Code differences: Congo, Dem. Rep., Serbia, Timor-Leste, Yemen, Rep., West Bank and Gaza
Countries not yet represented using ISO codes: Channel Islands, Kosovo
Request Format
http://api.worldbank.org/countries/br where "br" is the two-letter ISO code for Brazil.
Response Format
(Returns ISO 3 and ISO 2 codes wherever present, if not returns WB 3 and WB 2 codes)
XML
<wb:countries page="1" pages="1" per_page="50" total="1" xmlns:wb="http://www.worldbank.org">
- <wb:country id="BRA">
<wb:iso2Code>BR</wb:iso2Code>
<wb:name>Brazil</wb:name>
<wb:region id="LCN">Latin America & Caribbean (all income levels)</wb:region>
<wb:adminregion id="LCN">Latin America & Caribbean (all income levels)</wb:adminregion>
<wb:incomeLevel id="UMC">Upper middle income</wb:incomeLevel>
<wb:lendingType id="IBD">IBRD</wb:lendingType>
<wb:capitalCity>Brasilia</wb:capitalCity>
<wb:longitude>-47.9292</wb:longitude>
<wb:latitude>-15.7801</wb:latitude>
</wb:country>
</wb:countries>JSON
[{"page":1,"pages":1,"per_page":"50","total":1},[{"id":"BRA","iso2Code":"BR","name":"Brazil","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Brasilia","longitude":"-47.9292","latitude":"-15.7801"}]]Examples
To list all countries
http://api.worldbank.org/countries
Return entity data for particular country with ISO 3166-1 alpha-2 code “BR” (ISO 3166-1 alpha-3 code "BRA" can be used in place of alpha-2 code)
http://api.worldbank.org/countries/BR