# Verify the custom domain

> Checks the DNS records now. Checks are spaced out: inside the interval the answer is the domain as it stands. Needs a `domain:write` token.

```json
{
  "/api/v1/domain/verify": {
    "post": {
      "operationId": "verifyDomain",
      "tags": [
        "Domain"
      ],
      "summary": "Verify the custom domain",
      "description": "Checks the DNS records now. Checks are spaced out: inside the interval the answer is the domain as it stands. Needs a `domain:write` token.",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "responses": {
        "200": {
          "description": "The domain after the check.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Domain"
              }
            }
          }
        },
        "401": {
          "description": "Missing, unknown, revoked or expired token.",
          "content": {
            "application/problem+json": {
              "schema": {
                "$ref": "#/components/schemas/Problem"
              }
            }
          }
        },
        "403": {
          "description": "The token's scope does not allow this request.",
          "content": {
            "application/problem+json": {
              "schema": {
                "$ref": "#/components/schemas/Problem"
              }
            }
          }
        },
        "404": {
          "description": "The school has no live custom domain.",
          "content": {
            "application/problem+json": {
              "schema": {
                "$ref": "#/components/schemas/Problem"
              }
            }
          }
        }
      }
    }
  }
}
```