# List supported regions

Retrieve a list of supported regions where events can be staged.

Endpoint: GET /regions
Version: 3.0.0
Security: SessionKey

## Query parameters:

  - `records` (integer)
    The number of records per page that should be returned

  - `page` (integer)
    The number of the results page to return

  - `active` (boolean)
    Returns regions with one or more upcoming events, if true, or regions without upcoming events if false.

## Response 200 fields (application/json):

  - `total` (integer)
    The total number of results available

  - `page` (integer)
    The number of the results page returned

  - `records` (integer)
    The maximum number of results returned per page

  - `entries` (array)

  - `entries.self` (string)
    URI of the region resource

  - `entries.name` (string)
    Unique name of the region

  - `entries.country` (string)
    Country in which the region is located

  - `entries.district` (string)
    Parish, state, province, county, etc. in which the region is located

  - `entries.city` (string)
    City, town or village in which the region is located

  - `entries.icon` (string)
    URI of an icon that represents the region (e.g. flag)

## Response 404 fields (application/json):

  - `message` (string)
    Reason for the given response.