---
title: "List hosting configurations"
method: POST
path: "/mcp/v1/actions/ud_dns_hosting_list"
tags: ["DNS Management"]
---

# List hosting configurations

`POST /mcp/v1/actions/ud_dns_hosting_list`

## Request

- Base URL: `https://api.unstoppabledomains.com`
- URL: `https://api.unstoppabledomains.com/mcp/v1/actions/ud_dns_hosting_list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/user-api/docs/mcp/v1/actions/ud_dns_hosting_list/post.ts> (a function with typed inputs; its response is checked against the schema)

List hosting/forwarding configurations (redirects, reverse proxy, hosted sites, UD Profile).

## Request body

- object
  - `domain` string, required: Domain name
  - `cursor` string: Pagination cursor

## Response `200`

Hosting configurations

- DnsHostingListResponse
  - `domain` string
  - `configs` object[]
    - `type` 'GCS_HOSTED' | 'LISTING_PAGE' | 'REDIRECT_301' | 'REDIRECT_302' | 'REVERSE_PROXY' | 'UD_PROFILE' | 'STOREFRONT'
    - `subName` string, nullable: Subdomain (null for root)
    - `targetUrl` string, nullable: Destination URL (for redirects and reverse proxy)
    - `status` string
    - `certificateStatus` string, nullable
  - `pagination` object
    - `hasMore` boolean
    - `nextCursor` string, nullable

## Other responses

- `401`: Authentication required

## Changes

- **2026-03-13** `d4c4c4b514bd`: 2 warning
  - added the new `GCS_HOSTED` enum value to the `configs/items/type` response property for the response status `200`
  - added the new `REVERSE_PROXY` enum value to the `configs/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/unstoppabledomains/apis/user-api/changes/mcp/v1/actions/ud_dns_hosting_list/post.md)

---

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