API: Income Level Queries

About Income Levels Queries

Income levels show the income category of a particular country as identified by the World Bank. Income levels themselves just have a name and an id code. For more information on income level, including the methodology used by the World Bank, please visit Country Classification.

Request Format

http://api.worldbank.org/v2/incomeLevels

Response Format

XML

<wb:IncomeLevels page="1" pages="1" per_page="50" total="9" xmlns:wb="http://www.worldbank.org">
  <wb:incomeLevel id="HIC">High income</wb:incomeLevel>
  <wb:incomeLevel id="HPC">Heavily indebted poor countries (HIPC)</wb:incomeLevel>
  <wb:incomeLevel id="LIC">Low income</wb:incomeLevel>
  <wb:incomeLevel id="LMC">Lower middle income</wb:incomeLevel>
  <wb:incomeLevel id="LMY">Low & middle income</wb:incomeLevel>
  <wb:incomeLevel id="MIC">Middle income</wb:incomeLevel>
  <wb:incomeLevel id="NOC">High income: nonOECD</wb:incomeLevel>
  <wb:incomeLevel id="OEC">High income: OECD</wb:incomeLevel>
  <wb:incomeLevel id="UMC">Upper middle income</wb:incomeLevel>
  </wb:IncomeLevels>

JSON

[{"page":"1","pages":"1","per_page":"50","total":"9"},[{"id":"HIC","value":"High income"},{"id":"HPC","value":"Heavily indebted poor countries (HIPC)"},{"id":"LIC","value":"Low income"},{"id":"LMC","value":"Lower middle income"},{"id":"LMY","value":"Low & middle income"},{"id":"MIC","value":"Middle income"},{"id":"NOC","value":"High income: nonOECD"},{"id":"OEC","value":"High income: OECD"},{"id":"UMC","value":"Upper middle income"}]]

Examples

It is not common to query income level directly. It is more common to use income level as a way to delimit other calls. For example, to show a list of countries of the "Lower middle income" level, use the following call:

http://api.worldbank.org/v2/countries?incomeLevel=LMC

Thank you for visiting the World Bank's Data Help Desk. Please review the terms of use for this website. Your continued use of this website constitutes your acceptance of these terms and conditions.

Developer Info

Feedback and Knowledge Base