SearchCtrl+K

GeoDB APIs›Subregions API

Subregions API Reference

Retrieve all subregions within a specified world region. Given a region name, returns all geographic subdivisions belonging to that region.

GET

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

Test

The region parameter is required. Use exact region names returned by the Regions endpoint to avoid a 400 error.

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

Query Parameters

The region parameter is required to specify the region.

formatoptionalStringdefault: json

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

regionrequiredStringdefault: All Regions

Name of the region.

API Response Schema

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

subregions

Array<String>mandatory

An array of subregion names within the specified region. Each value represents a geographical subdivision, such as "Central Asia", "Eastern Asia", "Southeastern Asia", "Southern Asia", or "Western Asia".

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For details about supported status codes and error responses, refer to the HTTP Error Codes.

400

Please provide a valid region name.

404

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