# List hosting configurations

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.

Endpoint: GET /domains/{name}/dns/hosting
Version: 1.0.0
Security: bearer

## Path parameters:

  - `name` (string, required)
    Domain name

## Query parameters:

  - `$cursor` (string)
    Pagination cursor for retrieving the next page of results.

  - `subName` (array)
    Filter results by subdomain name(s).

## Response 200 fields (application/json):

  - `@type` (string, required)
    Enum: "unstoppabledomains.com/partner.v3.CursorList"

  - `items` (array, required)

  - `items.type` (string,null, required)
    Enum: "REDIRECT_301", "REDIRECT_302", "REVERSE_PROXY"

  - `items.targetUrl` (string,null, required)
    The target URL for redirect or reverse proxy configurations.

  - `items.subName` (string)
    The subdomain this configuration applies to. Empty string for root domain.

  - `items.status` (string, required)
    Current status of the hosting configuration.
    Enum: "ACTIVE", "INACTIVE", "PENDING"

  - `items.certificateStatus` (string, required)
    Status of the SSL certificate. Will be PENDING while the certificate is being provisioned.
    Enum: "ACTIVE", "INACTIVE", "PENDING"

  - `next` (object,null, required)

  - `next.cursor` (string)

## Response 400 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 403 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 404 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)