---
title: "Retrieve a Custom Domain"
method: GET
path: "/relays/{relay_id}/custom-domains/{id}"
tags: ["Core", "Relays"]
---

# Retrieve a Custom Domain

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

## Request

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

Retrieves a custom domain for a [Relay](/relay).

## Path parameters

- `relay_id` string, required
- `id` string, required

## Response `200`

The custom domain has been fetched.

- CustomDomain
  - `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`: 7 info
  - the response property `createdAt` became required for the status `200`
  - the response property `customDomain` became required for the status `200`
  - the response property `id` became required for the status `200`
  - the response property `relay` became required for the status `200`
  - …3 more

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/relays/:relay_id/custom-domains/:id/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)