---
title: "Verify a custom domain."
method: POST
path: "/v1/domains/{id}/verify"
tags: ["Domains"]
---

# Verify a custom domain.

`POST /v1/domains/{id}/verify`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/domains/{id}/verify`
- Auth: HTTP bearer

Confirms — via a standard public DNS lookup, no provider credentials — that the
customer's domain points at our edge (its A records match `cname.<platform>`,
or a configured `SCALIX_EDGE_IP`). On success, marks the domain active. This is
the industry-standard "does it point at us" check (Vercel/Netlify/Render).

## Path parameters

- `id` string, required

## Response `200`

DNS verification result

- VerifyDomainResponse: Response for `POST /v1/domains/{id}/verify`.
  - `verified` boolean, required
  - `domain` string, required
  - `status` string, required

## Other responses

- `401`: Missing or invalid credentials
- `404`: Domain not found
- `500`: DNS lookup failed

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)