# List managed hosts

Retrieve a list of registered event hosts for which this user has administrative permissions.

Endpoint: GET /accounts/{number}/hosts
Version: 3.0.0
Security: SessionKey

## Path parameters:

  - `number` (string, required)
    Alphanumeric identifier of the user account

## Query parameters:

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

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

## 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.