---
title: "List managed space hostnames"
method: GET
path: "/v1/managed-domains"
tags: ["Spaces"]
---

# List managed space hostnames

`GET /v1/managed-domains`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/managed-domains`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.spacefast.com/v1/auth/oauth2/authorize`, token URL `https://api.spacefast.com/v1/auth/oauth2/token`; client credentials, token URL `https://api.spacefast.com/v1/auth/oauth2/token`, scopes: `domains:read`)

Returns read-only, system-managed space.fast and view.fast hostnames for the caller's spaces. Pass `teamId` to limit the result to one team; custom domain inventory stays on /v1/domains.

## Query parameters

- `teamId` string: Return only hostnames owned by spaces in this team.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object[], required
    - `id` string, required: Stable managed row id derived from the default hostname row.
    - `source` 'managed_view_fast', required: System-managed hostname row.
    - `managed` true, required
    - `deletable` false, required
    - `assignable` false, required
    - `primary` boolean, required: Whether no custom primary domain overrides the managed URL.
    - `name` string, required: Managed hostname.
    - `unicodeName` string
    - `kind` 'hostname', required
    - `publicName` string, required: Left-hand public project label for the managed hostname.
    - `verification` object, required
      - `status` 'not_required', required
      - `requiredRecords` object[]: DNS records the caller must create to prove control and route traffic.
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' | 'ALIAS', required
        - `name` string, required: Record name to create, relative to the zone.
        - `value` string, required: Exact record value to set.
        - `ttl` integer
        - `purpose` 'verification' | 'routing' | 'ssl', required: Why this record is needed.
      - `lastCheckedAt` string, date-time, nullable: Instant when observed DNS was last polled.
      - `lastVerifiedAt` string, date-time, nullable: Instant when this domain last proved DNS control.
      - `diagnostics` object[]: Structured verification diagnostics with stable codes.
        - `code` string, required: Stable snake_case diagnostic code naming the public contract that produced it.
        - `severity` 'info' | 'warning' | 'error', required: How actionable the diagnostic is.
        - `message` string, required: Human-readable explanation with enough detail to act on.
        - `path` string, nullable: Artifact path the diagnostic points at, for example "_headers:12", when one exists.
        - `provider` 'infra' | 'dns' | 'registrar' | 'runtime', nullable: Upstream system the diagnostic originated from, when not Spacefast itself.
        - `details` object, nullable: Machine-readable context for the diagnostic code.
        - `fix` string, nullable: Concrete, agent-actionable remediation hint, when one can be derived.
        - `retryable` boolean, nullable: Whether retrying the same operation can resolve this diagnostic without the caller changing anything.
    - `attachedAt` string, date-time, nullable, required: The first recorded time that Spacefast attached this managed hostname.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `spaceId` string, required: Space that owns this managed hostname.
    - `spaceSlug` string, required: Current project slug for the owning space.
    - `spaceTitle` string, required: Current title for the owning space.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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