SearchCtrl+K

Subregions API Reference

Retrieve subregions within a region or country. Navigate the full geographic hierarchy from continent down to subregion level.

GET

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

Test

Given a region name, returns all subregions within that region.

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/subregions?region=Asia' \
  -H 'X-apiKey: API-KEY'

Response

{
  "subregions": [
    "Central Asia",
    "Eastern Asia",
    "Southeastern Asia",
    "Southern Asia",
    "Western Asia"
  ]
}

API Request Parameters

The following parameter is required to specify the region.

regionrequiredString

Name of the region.

API Response Schema

A successful request returns a 200 OK response with an array of subregion names.

subregions

Arraymandatory

An array of strings representing the subregions within the specified region.

subregions[]

Stringmandatory

A subregion name (e.g., "Southern Asia", "Western Europe", "Eastern Africa").

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

Please provide a valid region name.

404

The requested resource could not be found. Please verify the URL and try again.