# List event hosts

Retrieve a list of registered event hosts that match the given criteria.

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

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

  - `country` (string)
    If set, only returns hosts based in the specified country

  - `sort` (string)
    If set, determines how the returned hosts list is sorted
    Enum: "alphabetical"

  - `order` (string)
    If set along with the 'sort' parameter, determines whether the results will be sorted in ascending or descending order.
    Enum: "asc", "desc"

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

  - `entries.name` (string)
    Unique name of the event host

  - `entries.contact` (string)
    First and last name of the event host's primary contact person

  - `entries.email` (string)
    Primary contact email address of the event host

  - `entries.description` (string)
    Brief description of the nature of the events put on by the host

  - `entries.phone` (string)
    Primary contact number of the event host

  - `entries.website` (string)
    URL of the event host's website, if one exists

  - `entries.country` (string)
    The country in which the host's events will be primarily staged

  - `entries.firstAddressLine` (string)
    The first line of the event host's mailing address

  - `entries.secondAddressLine` (string)
    The second line of the event host's mailing address

  - `entries.city` (string)
    The city portion of the event host's mailing address

  - `entries.state` (string)
    The state, parish or district portion of the event host's mailing address

  - `entries.businessNo` (string)
    The event host's unique registration number, if it maintains a registered business entity

  - `entries.administrators` (string)
    URI of the host's administrative user collection

  - `entries.events` (string)
    URI of the collection of events being staged by this host

## Response 404 fields (application/json):

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