Regions API Reference

Retrieve a complete list of all world regions. Returns all standard geographic regions as a flat array of strings.

GET

https://api.apifreaks.com/v1.0/geo/regions

Test

Returns all geographical regions supported in the GeoDB system. No parameters are required.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/geo/regions' \
  -H 'X-apiKey: API-KEY'

Response

{
  "regions": [
    "Africa",
    "Americas",
    "Asia",
    "Europe",
    "Oceania",
    "Polar"
  ]
}

API Request

Query Parameters

The following optional parameter controls the response format.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the regions array.

regions

Array<String>mandatory

An array of region names representing all geographical regions supported by the service, such as "Africa", "Americas", "Asia", "Europe", "Oceania", and "Polar".