---
title: "A domain’s DNS records and nameservers"
method: GET
path: "/api/projects/{id}/domains/{domainId}/dns"
tags: ["domains"]
---

# A domain’s DNS records and nameservers

`GET /api/projects/{id}/domains/{domainId}/dns`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/projects/{id}/domains/{domainId}/dns`
- Auth: HTTP bearer

records is every record on Orgo DNS for the domain: A, AAAA, CNAME, MX, TXT and SRV, the types Orgo DNS serves (no NS, CAA or ALIAS). name is relative to the domain ("" for the domain itself, "www", "_dmarc", "*"); fqdn is the full name. A record with managed set was written by Orgo to serve a computer (the A record at a connected name and its _orgo-verify TXT): it changes with the computer’s custom domain, not here.

serving is whether the internet gets these records: true while the domain uses Orgo DNS’s nameservers (nameservers.mode "orgo"). With custom nameservers the records stay saved here but are not served. ttl_seconds is always null: Orgo DNS sets the TTL and it can’t be changed. Any member may read it, with a session, an account-wide key or a key for this workspace.

## Path parameters

- `id` string, uuid, required
- `domainId` string, uuid, required

## Response `200`

The zone.

- DnsZone
  - `domain` string, required
  - `nameservers` Nameservers, required
    - `mode` 'orgo' | 'custom', required: orgo: Orgo DNS serves the domain’s records. custom: another provider does.
    - `list` string[], required: The nameservers the registry has for the domain.
  - `serving` boolean, required: The internet gets these records: the domain uses Orgo DNS’s nameservers.
  - `ttl_seconds` unknown, required
  - `records` DomainDnsRecord[], required
    - `id` string, required: Made from the record’s content: it changes when the record does.
    - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'SRV', required
    - `name` string, required: Relative to the domain: "" for the domain itself, "www", "_dmarc", "*".
    - `fqdn` string, required
    - `value` string, required: An IPv4 or IPv6 address, a hostname (no trailing dot), or text.
    - `priority` integer: MX and SRV.
    - `weight` integer: SRV.
    - `port` integer: SRV.
    - `managed` object, nullable, required: Set on a record Orgo wrote to serve a computer; it can’t be changed here.
      - `computer_id` string, uuid
      - `computer_name` string, nullable
      - `custom_domain_id` string, uuid

## Other responses

- `401`: Unauthenticated.
- `403`: No access to this workspace (no code), a key for another workspace (workspace_scope_mismatch), or a share-link guest.
- `404`: Domains are not enabled for this account (DOMAINS_NOT_ENABLED), or the workspace has no such domain (DOMAIN_NOT_FOUND). A workspace you are not in answers 403.
- `409`: The domain is still being registered (DOMAIN_PENDING). Try again in a few minutes.
- `429`: Over one of the account's rate limits (rate_limited): `limit` names it, `retry_after` and Retry-After say how many seconds to wait. Limits are per account (the workspace owner when the request acts on a computer or a workspace) and set by its plan (x-rate-limits).
- `502`: Orgo DNS did not answer (REGISTRAR_UNAVAILABLE). Try again.
- `503`: Domains are unavailable right now (DOMAINS_UNAVAILABLE).

## Changes

- **2026-11-01** `60e768a2bb9d`: 9 info
  - added the optional property `docs_url` to the response with the `404` status
  - added the optional property `docs_url` to the response with the `409` status
  - added the optional property `docs_url` to the response with the `502` status
  - added the optional property `next` to the response with the `404` status
  - …5 more
- **2026-10-30** `afb6f0ee1aac`: 1 info
  - added the non-success response with the status `429`
- **2026-10-22** `a506f6169bb5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/projects/:id/domains/:domainId/dns/get.md)

---

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