Country Calls

The API provides four country based calls that provide lists of countries, regions, country income levels, and the type of World Bank lending for which each country is eligible.

• wb.countries.get
• wb.incomeLevels.get
• wb.lending.types.get
• wb.regions.get

For more information on how the World Bank classifies countries and determines income level and lending eligilibity, see Country Classification.

wb.countries.get

Gets information about a country (or a group of countries).

Arguments

api_key (Required)
    Your API key.
id (Optional)
    The three-letter ISO code of the country
name (Optional)
    The name of the country
iso2Code (Optional)
    The two-letter ISO code of the country
region (Optional)
    The country's region
incomeLevel (Optional)
    The country's income level code
lendingType (Optional)
    The country's lending type code
page (Optional)
    The page of results to return. If this argument is omitted, it defaults to 1.
per_page (Optional)
    The number of countries to return per page.  If this argument is omitted, it defaults to 10.  The maximum allowed value is 100.

Example Response

wb.test.echo

Error Codes

100: Invalid API Key
            The API key passed was not valid or has expired.
105: Service currently unavailable
            The requested service is temporarily unavailable.
110: API version “xxx” not found
            The requested API version was not found.
111: Format “xxx” not found
            The requested response format was not found.
112: Method “xxx” not found
            The requested method was not found.
115: Missing required parameter
            Parameters which are required have not been sent.
120: Parameter “xxx” has an invalid value
            The provided parameter is not valid.

Gets information about an income level.

Arguments

api_key (Required)
    Your API key.
id (Optional)
    The id of the income level.
page (Optional)
    The page of results to return. If this argument is omitted, it defaults to 1.
per_page (Optional)
    The number of income levels to return per page.  If this argument is omitted, it defaults to 10.  The maximum allowed value is 100.

Example Response

Error Codes

100: Invalid API Key
            The API key passed was not valid or has expired.
105: Service currently unavailable
            The requested service is temporarily unavailable.
110: API version “xxx” not found
            The requested API version was not found.
111: Format “xxx” not found
            The requested response format was not found.
112: Method “xxx” not found
            The requested method was not found.
115: Missing required parameter
            Parameters which are required have not been sent.
120: Parameter “xxx” has an invalid value
            The provided parameter is not valid.

Gets information about a lending type.

Arguments

api_key (Required)
    Your API key.
id (Optional)
    The id of the lending type.
page (Optional)
    The page of results to return. If this argument is omitted, it defaults to 1.
per_page (Optional)
    The number of lending types to return per page.  If this argument is omitted, it defaults to 10.  The maximum allowed value is 100.

Example Response

Error Codes

100: Invalid API Key
            The API key passed was not valid or has expired.
105: Service currently unavailable
            The requested service is temporarily unavailable.
110: API version “xxx” not found
            The requested API version was not found.
111: Format “xxx” not found
            The requested response format was not found.
112: Method “xxx” not found
            The requested method was not found.
115: Missing required parameter
            Parameters which are required have not been sent.
120: Parameter “xxx” has an invalid value
            The provided parameter is not valid.

Gets information about a region.

Arguments

api_key (Required)
    Your API key.
id (Optional)
    The id of the region.
page (Optional)
    The page of results to return. If this argument is omitted, it defaults to 1.
per_page (Optional)
    The number of regions to return per page.  If this argument is omitted, it defaults to 10.  The maximum allowed value is 100.

Example Response

Error Codes

100: Invalid API Key
            The API key passed was not valid or has expired.
105: Service currently unavailable
            The requested service is temporarily unavailable.
110: API version “xxx” not found
            The requested API version was not found.
111: Format “xxx” not found
            The requested response format was not found.
112: Method “xxx” not found
            The requested method was not found.
115: Missing required parameter
            Parameters which are required have not been sent.
120: Parameter “xxx” has an invalid value
            The provided parameter is not valid.