---
title: "Check the TXT record now, and whether the name points here."
method: POST
path: "/v1/domains/{hostname}:verify"
tags: ["domains"]
---

# Check the TXT record now, and whether the name points here.

`POST /v1/domains/{hostname}:verify`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/domains/{hostname}:verify`
- Auth: HTTP bearer

## Path parameters

- `hostname` string, required: The hostname, such as app.example.com.

## Headers

- `Idempotency-Key` string

## Response `200`

Success

- object
  - `id` string
  - `hostname` string
  - `sandboxId` string, nullable: The sandbox it serves; null for an App's.
  - `appId` string, nullable: The App it serves; null for a sandbox's port.
  - `port` integer
  - `state` string: pending (prove it with the TXT record), active, or released.
  - `url` string
  - `disabled` boolean: Turned off by Runtime after a report. Contact support.
  - `records` object[]
    - `type` string
    - `name` string
    - `value` string
    - `purpose` string
  - `verifiedAt` string, date-time, nullable
  - `checkedAt` string, date-time, nullable
  - `checkError` string, nullable
  - `certificate` object, nullable: An App's domain's certificate, issued before visitors arrive: point the name at the App once ready is true. Null for a sandbox's.
    - `ready` boolean
    - `expiresAt` string, date-time, nullable
    - `issuers` string[]
  - `createdAt` string, date-time
  - `pointed` boolean, nullable: The name resolves to Runtime's edge now.
  - `hint` string

## Other responses

- `default`: Error

---

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