---
title: "Verify Custom Domain"
method: POST
path: "/companies/{company_id}/custom-domain/verify"
tags: ["vercel"]
---

# Verify Custom Domain

`POST /companies/{company_id}/custom-domain/verify`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/custom-domain/verify`
- Auth: HTTP bearer

Check DNS verification status for a company's custom domain.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- CustomDomainVerifyResponse
  - `domain` string, required
  - `verified` boolean, required
  - `dns_records` DnsRecord[]
    - `type` string, required
    - `domain` string, required
    - `value` string, required
  - `email` DomainEmailStatus: Email on a domain bought in NanoCorp (spec §9.5); null for any other domain.
    - `address` string, nullable
    - `status` string, required
    - `sending_enabled` boolean, required
    - `platform_address` string, required
    - `records` DomainEmailRecord[]
      - `name` string, required
      - `type` string, required
      - `value` string, required
      - `priority` integer, nullable
      - `status` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-19** `734278ef1b5b`: 1 info
  - added the optional property `email` to the response with the `200` status

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/custom-domain/verify/post.md)

---

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