Loading
Loading
Retrieve a complete list of countries with ISO codes, capitals, regions, and subregions. Optionally filter by region or subregion.
Returns all countries with their ISO codes, capital cities, regions, and subregions. Optional region and subregion parameters narrow results.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following optional parameters can be used to filter the countries list.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
regionoptionalStringdefault: All RegionsOptional filter to return countries within a specific region from the region endpoint.
subregionoptionalStringdefault: All SubregionsOptional filter to return countries within a specific subregion from the subregion endpoint.
A successful request returns a 200 OK response with a JSON object containing the countries array.
An array of country objects matching the applied filters.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Please provide a valid region name.
Please provide a valid subregion name.