# List user accounts

Retrieve a list of TickeTing user accounts.

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

  - `number` (string)
    If set, only returns the account with the specified number

  - `email` (string)
    If set, only returns the account with the specified email address

  - `username` (string)
    If set, only returns the account with the specified username

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

  - `entries.number` (string)
    Immutable identifier attached to the account

  - `entries.username` (string)
    Unique username attached to the account

  - `entries.email` (string)
    Unique email address attached to the account

  - `entries.role` (string)
    User role assigned to the account
    Enum: "customer", "support", "host", "administrator"

  - `entries.verified` (boolean)
    True if the account email address has been verified, false otherwise

  - `entries.activated` (boolean)
    True if the account is active, false if it has been deactivated

  - `entries.firstName` (string)
    The account holder's forename

  - `entries.lastName` (string)
    The account holder's surname

  - `entries.title` (string)
    The account holder's formal title
    Enum: "Mr", "Mrs", "Ms", "Mx"

  - `entries.dateOfBirth` (string)
    The account holder's date of birth

  - `entries.phone` (string)
    The account holder's primary contact number

  - `entries.country` (string)
    The country associated with the account (used for regionalisation)

  - `entries.firstAddressLine` (string)
    The first line of the account holder's address

  - `entries.secondAddressLine` (string)
    The second line of the account holder's address

  - `entries.city` (string)
    The city portion of the account holder's address

  - `entries.state` (string)
    The state, parish or district portion of the account holder's address

  - `entries.preferences` (string)
    URI of the account's user preferences resource

## Response 404 fields (application/json):

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