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

# List hosting configurations

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

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/domains/{name}/dns/hosting`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/domains/:name/dns/hosting/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-03** `f2c42c8ffa95`: 1 warning, 1 info
  - removed the optional property `next/allOf[#/components/schemas/CursorListResponseNext]/cursor` from the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/CursorListResponseNext]/$cursor` to the response with the `200` status
- **2026-03-10** `5406056d272c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/domains/:name/dns/hosting/get.md)

---

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