# Return WordPress installations

This function returns the caller's WordPress installations. Each row is
identical in shape to the get_website response data, so the same
consumer mapping works for both.

  Note:

  - Ownership is enforced by filesystem path: only installations under the
    caller's home directory are returned.
  - Each row carries the installation's health as flat flags
    (alive, broken, infected, outdated_php, outdated_wp,
    unsupported_php, unsupported_wp), taken directly from WordPress
    Toolkit.

Endpoint: GET /WPX/list_websites
Version: 11.138.0.10
Security: BasicAuth

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "list_websites"

  - `module` (string)
    The name of the module called.
    Example: "WPX"

  - `result` (object)

  - `result.data` (object)
    The installations and summary counts.

  - `result.data.domains` (array)
    The caller's WordPress installations.

  - `result.data.domains.admin_url` (string)
    The WordPress administrator login URL.
    Example: "https://blog.example.com/wp-login.php"

  - `result.data.domains.alive` (integer)
    Whether the installation is responding.
    Enum: 1, 0

  - `result.data.domains.broken` (integer)
    Whether WordPress Toolkit reports the installation as broken.
    Enum: 1, 0

  - `result.data.domains.documentroot` (string)
    The filesystem path to the WordPress root.
    Example: "/home/user/public_html"

  - `result.data.domains.domain` (string)
    The normalized bare hostname of the site.
    Example: "blog.example.com"

  - `result.data.domains.infected` (integer)
    Whether WordPress Toolkit reports the installation as infected.
    Enum: 1, 0

  - `result.data.domains.outdated_php` (integer)
    Whether the installation runs an outdated PHP version.
    Enum: 1, 0

  - `result.data.domains.outdated_wp` (integer)
    Whether the installation runs an outdated WordPress version.
    Enum: 1, 0

  - `result.data.domains.title` (string)
    The WordPress site title. May be empty.
    Example: "My Blog"

  - `result.data.domains.unsupported_php` (integer)
    Whether the installation runs an unsupported PHP version.
    Enum: 1, 0

  - `result.data.domains.unsupported_wp` (integer)
    Whether the installation runs an unsupported WordPress version.
    Enum: 1, 0

  - `result.data.domains.url` (string)
    The public site URL.
    Example: "https://blog.example.com"

  - `result.data.domains.version` (string)
    The WordPress version. May be empty if unknown.
    Example: "6.4.2"

  - `result.data.domains.wptk_id` (integer,null)
    The WordPress Toolkit instance id. This is null when the
upstream record carries no id. Guard against that before
you send the value to a function that takes an id
parameter, because WordPress Toolkit ids are positive
integers and there is no valid 0.
    Example: 17

  - `result.data.info` (object)
    Summary counts for the result set.

  - `result.data.info.disk_quota_reached` (integer)
    Whether the account has reached the disk quota that blocks a new install.
    Enum: 1, 0

  - `result.data.info.results` (integer)
    The number of installations returned.
    Example: 3

  - `result.data.info.total` (integer)
    The total number of installations.
    Example: 3

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.metadata.transformed` (integer)
    Post-processing may have transformed the data.
    Enum: 1

  - `result.status` (integer)
    - 1 - Success.
- 0 - Failed: Check the errors field for more details.
    Enum: 1, 0

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.