---
title: "List all custom domains and their verification statuses for the project"
method: GET
path: "/projects/{id}/custom_domains"
tags: ["Notifications"]
---

# List all custom domains and their verification statuses for the project

`GET /projects/{id}/custom_domains`

## Request

- Base URL: `https://api.hookdeck.com/2025-07-01`
- URL: `https://api.hookdeck.com/2025-07-01/projects/{id}/custom_domains`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Path parameters

- `id` string, required: Project ID

## Response `200`

List of custom domains

- object[]
  - `id` string
  - `hostname` string
  - `status` string
  - `ssl` object
    - `id` string
    - `type` string
    - `method` string
    - `status` string
    - `txt_name` string
    - `txt_value` string
    - `validation_records` object[]
      - `status` string
      - `txt_name` string
      - `txt_value` string
    - `dcv_delegation_records` object[]
      - `cname` string
      - `cname_target` string
    - `settings` object
      - `min_tls_version` string
    - `bundle_method` string
    - `wildcard` boolean
    - `certificate_authority` string
  - `verification_errors` string[]
  - `ownership_verification` object
    - `type` string
    - `name` string
    - `value` string
  - `created_at` string

## Changes

- **2026-09-24** `9bebff6c68f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/changes/projects/:id/custom_domains/get.md)

---

[API](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api.md) - [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/revisions/b1b6f4bac5a1?raw)