---
title: "List Agency Plan websites"
method: GET
path: "/api/agency-hosting/v1/websites"
tags: ["Agency Hosting: Websites"]
---

# List Agency Plan websites

`GET /api/agency-hosting/v1/websites`

Retrieve a paginated list of Agency Plan websites (H5G, Builder, and Horizons) accessible to
the authenticated client.

This endpoint returns websites from your hosting accounts as well as
websites from other client hosting accounts that have shared access
with you.

The response shape differs per platform — see the `platform` field on each item.

Use `website_types` to list only websites of a given detected type, e.g. only
WordPress websites (`website_types=wordpress`) or only Node.js websites
(`website_types=nodejs`). Combine with `order_ids`, `states`, or `domain` for more
targeted results.

## Query parameters

- `page` integer
- `per_page` integer
- `order_ids` integer[], nullable
- `states` string[], nullable
- `website_types` string[], nullable
- `domain` string, nullable

## Response `200`

Success response

- object
  - `data` AgencyHostingV1WebsitesWebsiteListItemResource[] — Array of [`AgencyHosting.V1.Websites.WebsiteListItemResource`](#model/agencyhostingv1websiteswebsitelistitemresource)
    - `id` string, required
    - `client_id` integer, required
    - `order_id` integer, required
    - `platform` 'h5g' | 'builder' | 'u4s', required — Website platform
    - `state` string, required — Website state
    - `created_at` string, date-time, required
    - `plan` AgencyHostingV1WebsitesPlanResource, required — Website plan details
      - `name` string
      - `display_name` string
      - `has_cdn` boolean
    - `details` union, required — Platform-specific website details. Shape depends on `platform`.
      - AgencyHostingV1WebsitesH5gWebsiteDetailsResource
        - `uid` string — Website UID
        - `ipv4` string — IPv4 address
        - `flavor` string — Setup flavor
        - `type` 'wordpress' | 'builder' | 'horizons' | 'nodejs' | 'u4s' | 'other' — Detected website type
        - `username` string — Username for this order
        - `description` string, nullable — Description
        - `state` 'active' | 'suspended' — Website state
        - `created_at` string, date-time
        - `settings` object — Website settings, e.g. PHP configuration
        - `wordpress` object, nullable — WordPress installation details
        - `domains` object[] — Website domains
        - `preview_domain` object, nullable — Preview domain
        - `processes` object[] — Ongoing website processes
        - `horizons_uuid` string, nullable — Horizons UUID (only for horizons websites)
      - AgencyHostingV1WebsitesBuilderWebsiteDetailsResource
        - `id` string, nullable — Builder ID
        - `vhost` string — Domain name
        - `type` string — Detected website type
        - `username` string — Account username
        - `created_at` string, date-time
      - AgencyHostingV1WebsitesU4sWebsiteDetailsResource
        - `uuid` string — Application UUID
        - `title` string — Application title
        - `port` integer — Application port
        - `type` 'u4s' | 'horizons' — Detected website type
        - `runtime` string — Application runtime
        - `state` string — Application state
        - `domains` object[] — Application domains
        - `horizons_uuid` string, nullable — Horizons UUID
        - `preview_domain` object, nullable — Preview domain
    - `suspension_reason` string, nullable, required — Reason for suspension, only populated for payment related suspensions
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/17d492a8f422/schema)