# Read the custom domain

> The school's live main-site domain with the DNS records to publish. Needs a `site:read` token.

```json
{
  "/api/v1/domain": {
    "get": {
      "operationId": "getDomain",
      "tags": [
        "Domain"
      ],
      "summary": "Read the custom domain",
      "description": "The school's live main-site domain with the DNS records to publish. Needs a `site:read` token.",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "responses": {
        "200": {
          "description": "The domain.",
          "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"
              }
            }
          }
        }
      }
    }
  }
}
```