---
title: "List custom domains"
method: GET
path: "/hosting/custom-domains/list"
tags: ["Hosting - Custom Domains"]
---

# List custom domains

`GET /hosting/custom-domains/list`

List custom domains attached to an app or worker

## Query parameters

- `appUuid` string, uuid — Identifier of the app whose custom domains to list.
- `workerUuid` string, uuid — Identifier of the worker whose custom domains to list.

## Response `200`

Successful response

- object
  - `customDomains` union[], required — List of custom domains attached to the subject.
    - union
      - object
        - `uuid` string, uuid, required
        - `workspaceUuid` string, uuid, required
        - `hostname` string, required
        - `status` 'pending_verification' | 'verifying' | 'active' | 'failed' | 'deactivated', required
        - `verifiedAt` string, nullable, required
        - `verification` object[], required
          - `recordType` 'CNAME' | 'TXT', required
          - `name` string, required
          - `value` string, required
        - `cnameTarget` string, nullable, required
        - `chargedUntil` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `kind` 'app', required
        - `appUuid` string, uuid, required
      - object
        - `uuid` string, uuid, required
        - `workspaceUuid` string, uuid, required
        - `hostname` string, required
        - `status` 'pending_verification' | 'verifying' | 'active' | 'failed' | 'deactivated', required
        - `verifiedAt` string, nullable, required
        - `verification` object[], required
          - `recordType` 'CNAME' | 'TXT', required
          - `name` string, required
          - `value` string, required
        - `cnameTarget` string, nullable, required
        - `chargedUntil` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `kind` 'worker', required
        - `workerUuid` string, uuid, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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