WordPress: Installations

List WordPress installations

Changed on

List WordPress installations on shared and cloud web hosting accounts (the /api/hosting/v1 family, identified by username) accessible to the authenticated client.

Agency Plan websites are not included. To work with WordPress on an Agency Plan website, list them with GET /api/agency-hosting/v1/websites?website_types=wordpress and read their details with GET /api/agency-hosting/v1/websites/{website_uid}/wordpress/settings. An account that only has Agency Plan websites receives an empty list from this endpoint.

Use this endpoint to discover existing WordPress installations and to poll for installation status after calling the install endpoint. When a newly requested installation appears in this list, WordPress is ready. Filter by username and domain to narrow results to a specific website.

Each installation includes a valid flag and, when invalid, a validationError describing why.

get/api/hosting/v1/wordpress/installations

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/hosting/v1/wordpress/installations
  • Auth: HTTP bearer

Query parameters

usernamestring nullable
Example:cl_user123

Filter by specific username

domainstring nullable
Example:example.com

Filter by domain name (case-insensitive substring match)

ownership'owned' | 'managed' | 'all' nullable
Example:owned

Filter by ownership type. Defaults to "owned". Use "all" to include both owned and managed installations.

Response

Success response

idstring

WordPress installation (software) id

usernamestring

Hosting account username

domainstring

Domain the installation belongs to

site_titlestring

WordPress site title

urlstring

WordPress site URL

directorystring

Installation directory

languagestring

WordPress locale

loginstring

WordPress admin username

emailstring

WordPress admin email

is_validboolean

Whether the installation is considered valid

validation_errorstring nullable

Reason the installation is invalid, if any

created_atstring date-time

Installation creation timestamp

Example response

[
  {
    "id": "123",
    "username": "u123456789",
    "domain": "example.com",
    "site_title": "My site",
    "url": "https://example.com",
    "directory": "public_html",
    "language": "en_US",
    "login": "admin",
    "email": "owner@example.com",
    "is_valid": true,
    "validation_error": "Invalid domain",
    "created_at": "2022-01-01T00:00:00Z"
  }
]

Changes