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.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
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.