---
title: "Get the details for all custom domains."
method: GET
path: "/orgs/{org}/custom-domains/"
tags: ["orgs"]
---

# Get the details for all custom domains.

`GET /orgs/{org}/custom-domains/`

Get the details for all custom domains.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Retrieved the list of custom domains for the organization.

- OrganizationCustomDomains[]
  - `backend_kind` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 99, nullable — The domain for a specific package format.
  - `created_at` string, date-time
  - `created_by` integer, nullable
  - `dns_alias_value` string, nullable — The CNAME value to use to publish this domain publicly.
  - `dns_cert_name` string, nullable — The CNAME name to create to allow us to generate a TLS cert.
  - `dns_cert_value` string, nullable — The CNAME value to use to allow us to generate a TLS cert.
  - `domain_type` 0 | 1 | 2 | 3 — The type for the custom domain.
  - `enabled` boolean — If checked, the domain is enabled.
  - `host` string
  - `namespace` integer
  - `primary` boolean — If checked, this domain is the preferred/primary domain in the case that there are other overlapping domains (e.g. for the same repository, package format, etc.)
  - `redirect_root` boolean — If checked, the domain root redirects to the repository.
  - `redirect_root_url` string, uri, nullable — Where root requests should be redirected to if redirect_root is enabled.
  - `repository` OrganizationCustomDomainNestedRepo, required
    - `name` string — A descriptive name for the repository.
    - `slug` string, slug — The slug identifies the repository in URIs.
  - `repository_only` boolean — If checked, the domain applies to a specific repository only.
  - `slug_perm` string, slug
  - `validated` boolean — If validated, the domain is ready for requests.
  - `validated_at` string, date-time

## Other responses

- `400` — Request could not be processed (see detail).
- `402` — Custom Domains are not available; upgrade your account!
- `404` — Organization not found.
- `422` — Missing or invalid parameters (see detail).

---

[API](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1.md) · [All operations](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudsmith/cloudsmith-api-v1/revisions/4d7879df9b2f/schema)