---
title: "List hosting configurations"
method: GET
path: "/domains/{name}/dns/hosting"
tags: ["hosting"]
---

# List hosting configurations

`GET /domains/{name}/dns/hosting`

Retrieve all hosting configurations for the specified domain. Each configuration represents how a domain or subdomain serves content (e.g., redirect, reverse proxy).

Use the `subName` parameter to filter results to specific subdomains. Results are paginated — use the `$cursor` parameter to retrieve subsequent pages.

## Path parameters

- `name` string, required

## Query parameters

- `$cursor` string
- `subName` string[]

## Response `200`

List of hosting configurations

- DomainHostingDetailsResponses — Paginated list of hosting configurations for a domain.
  - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
  - `items` DomainHostingDetailsItemResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.DomainHostingDetails', required
    - `type` 'REDIRECT_301' | 'REDIRECT_302' | 'REVERSE_PROXY', required
    - `targetUrl` string, nullable, required — The target URL for redirect or reverse proxy configurations.
    - `subName` string — The subdomain this configuration applies to. Empty string for root domain.
    - `status` 'ACTIVE' | 'INACTIVE' | 'PENDING', required — Current status of the hosting configuration.
    - `certificateStatus` 'ACTIVE' | 'INACTIVE' | 'PENDING', required — Status of the SSL certificate. Will be `PENDING` while the certificate is being provisioned.
  - `next` CursorListResponseNext, required
    - `$cursor` string

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

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