---
title: "List website setups"
method: GET
path: "/api/hosting/v1/onboardings"
tags: ["Hosting: Websites"]
---

# List website setups

`GET /api/hosting/v1/onboardings`

Returns the website setups started in the last 24 hours for the hosting accounts
accessible to the authenticated client, newest first. Narrow the list with the
`order_id`, `subscription_id` or `domain` filters.

Meant for polling right after creating a website or starting a website setup: the
website shows up in the websites list before its server-side setup has finished, and
while the setup is `running` endpoints that operate on that website may respond with
`404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and
wait for `status: completed` before uploading files, deploying or creating databases.
`failed` means the setup stopped before finishing or has not reported progress for
over an hour. Setups older than 24 hours are not listed.

`type` is the website type the setup was started with (`wordpress`, `headless_wordpress`,
`headless_ecommerce`, `headless_pocketbase`), or `null` for an empty website.

## Query parameters

- `order_id` integer, nullable
- `subscription_id` string, nullable
- `domain` string, nullable

## Response `200`

Success response

- HostingV1OnboardingsOnboardingResource[] — Array of [`Hosting.V1.Onboardings.OnboardingResource`](#model/hostingv1onboardingsonboardingresource)
  - `domain` string, required — Domain of the website being set up.
  - `username` string, required — Hosting account username.
  - `type` string, nullable — Website type requested for the setup: `wordpress`, `headless_wordpress`, `headless_ecommerce` or `headless_pocketbase`. `null` for an empty website. Setups started outside this API may report other legacy types.
  - `status` 'running' | 'completed' | 'failed', required — `running` while the website is still being set up, `completed` once the setup has finished, `failed` when it stopped before finishing or has not reported progress for over an hour.
  - `created_at` string, date-time, required — When the setup was requested.
  - `updated_at` string, date-time, required — When the setup last reported progress.

## Other responses

- `401` — Unauthenticated response
- `422` — Validation error response
- `500` — Error response

## Changes

- **2026-10-06** `f086c8278a09` — 3 info
  - added the new optional `query` request parameter `order_id`
  - added the new optional `query` request parameter `subscription_id`
  - added the optional property `items/type` to the response with the `200` status
- **2026-09-28** `80eb9c227033` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hostinger/apis/hostinger-api/changes/api/hosting/v1/onboardings/get.md)

---

[API](https://skmtc.dev/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.dev/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hostinger/apis/hostinger-api/revisions/f086c8278a09?raw)