---
title: Regions API - Retrieve World Regions & Subregions
version: 1.0.0
description: Retrieve all geographical regions supported by the GeoDB service. Returns a flat array of exactly 6 region names - Africa, Americas, Asia, Europe, Oceania, and Polar. This endpoint takes no required parameters, ignores unrecognized query parameters rather than erroring, and has no documented error responses. Use the returned region names with the Subregions endpoint to drill down into subregional data.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 1
---

## Table of Contents

- [Regions API - Retrieve World Regions & Subregions v1.0.0](#regions-api-retrieve-world-regions-subregions-v100)
  - [Authentication](#authentication)
  - [GeoDB APIs](#geodb-apis)
    - [getRegions](#getregions)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [RegionsResponse](#regionsresponse)



# Regions API - Retrieve World Regions & Subregions v1.0.0

Retrieve all geographical regions supported by the GeoDB service. Returns a flat array of exactly 6 region names - Africa, Americas, Asia, Europe, Oceania, and Polar. This endpoint takes no required parameters, ignores unrecognized query parameters rather than erroring, and has no documented error responses. Use the returned region names with the Subregions endpoint to drill down into subregional data.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## GeoDB APIs

### getRegions

`GET /geo/regions`

*Retrieve all geographical regions*

Returns all geographical regions supported by the service, such as Africa, Americas, Asia, Europe, Oceania, and Polar.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Format of the response. Possible values: json, xml.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|

> Example responses

> Successful response with list of regions

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

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response with list of regions|[RegionsResponse](#regionsresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### RegionsResponse

Response containing the flat list of geographical regions supported by the GeoDB service.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|regions|[string]|true|none|An array of region names representing all geographical regions supported by the service.|