# List event venues

Retrieve a list of approved venues at which events can be hosted.

Endpoint: GET /venues
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

  - `region` (string)
    If set, only returns venues located in the specified region

  - `name` (string)
    If set, only returns venues whose name matches the specified regular expression

## 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 venue resource

  - `entries.name` (string)
    Name of the event venue

  - `entries.region` (string)
    URI of the region resource related to this venue

  - `entries.latitude` (number)
    Global latitude of the event venue's location

  - `entries.longitude` (number)
    Global longitude of the event venue's location

  - `entries.address` (string)
    Text representation of the event venue's address

  - `entries.map` (string)
    URI to a static Google Maps image of the event venue's location

## Response 404 fields (application/json):

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