---
title: "List all Custom Domains"
method: GET
path: "/relays/{relay_id}/custom-domains"
tags: ["Core", "Relays"]
---

# List all Custom Domains

`GET /relays/{relay_id}/custom-domains`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/relays/{relay_id}/custom-domains`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/relays/:relay_id/custom-domains/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all custom domains for a [Relay](/relay).

## Path parameters

- `relay_id` string, required

## Response `200`

The Relay's custom domains have been fetched.

- object
  - `data` CustomDomain[], required
    - `id` string, required: The unique identifier for the custom domain.
    - `customDomain` string, required: The customer managed domain to which requests to be relayed to your domain should be sent.
    - `relay` string, required: The ID of the Relay with which this custom domain is associated.
    - `status` 'active' | 'inactive', required: The status of the domains DNS verification.
    - `validationRecord` string, uuidv4, required: Validation TXT record to be added on the `_ev-custom-relay` subdomain of your custom domain
    - `createdAt` integer, required: The exact time, in epoch milliseconds, when this custom domain was created.
    - `updatedAt` integer, required: The exact time, in epoch milliseconds, when this custom domain was last updated.

## Changes

- **2026-11-06** `8d0ca833fa04`: 8 info
  - the response property `data` became required for the status `200`
  - the response property `data/items/createdAt` became required for the status `200`
  - the response property `data/items/customDomain` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - …4 more
- **2025-11-18** `30ea25af4354`: 1 info
  - api tag `Core` added

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/relays/:relay_id/custom-domains/get.md)

---

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