# Check DNS again

`POST /service/@id/builder/sites/@site/domains/@hostname/verify` · TinoPage Builder, service owner's sign-in token

Checks the domain's DNS records now (up to about 12 seconds) and returns the domain after the check. With both CNAME and TXT in place `status` turns `active` and HTTPS is issued automatically; otherwise `error` says what is missing. TinoPage Builder also rechecks `pending` domains on a schedule (`next_check_at`).

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites/@site/domains/@hostname/verify` |
| Method | `POST` |
| Authentication | the TinoPage Builder service owner's sign-in token (`Authorization: Bearer <token>`); the `/v1` gateway does not expose TinoPage Builder yet |
| Content-Type | `application/json` |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | int | yes | TinoPage Builder service ID |
| `site` | path | string | yes | Website ID (UUID, `id` in the website list) |
| `hostname` | path | string | yes | Custom domain in lower case (`hostname` in the domain list) |
| `idempotency_key` | body | string | no | 8–64 characters `A-Za-z0-9._:-`: resending the same key and content returns the earlier result instead of running again |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100003/builder/sites/5b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e/domains/banhang.example.vn/verify" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "idempotency_key": "kiem-dns-0001"
}'
```

`$TINO_TOKEN` is the TinoPage Builder service owner's sign-in token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("POST", "/service/@id/builder/sites/@site/domains/@hostname/verify")`.

## Example response

```json
{
 "data": {
  "hostname": "banhang.example.vn",
  "status": "pending",
  "ssl_status": "pending",
  "txt_ok": false,
  "cname_ok": false,
  "dns": [
   {
    "type": "CNAME",
    "name": "banhang",
    "value": "dns.tino.page"
   },
   {
    "type": "TXT",
    "name": "_tino-verify.banhang",
    "value": "tino-site-verify=4b6d0e2a7c914f3e8a5b1c2d9e0f7a6b"
   }
  ],
  "error": "thiếu bản ghi TXT _tino-verify; CNAME chưa trỏ về dns.tino.page",
  "checked_at": "2026-10-26T03:30:00Z",
  "url": "https://banhang.example.vn",
  "owner_verified": false,
  "check_count": 1,
  "next_check_at": "2026-10-26T03:35:00Z"
 }
}
```

Sample built from the TinoPage Builder API (Tino relays the answer as is inside `data`); values are examples.