List org zones
GEThttps://api.instacloud.com/orgs/{orgId}/zones
Token scope: account · org — read-only tokens allowed.
The org's BYO delegated zones, each with its nameservers and the sweeper's last is-it-pointed-yet observation (refreshed about every minute at small fleet sizes; no per-request DNS).
Set limit or cursor to request a page; continue with nextCursor until null. Without either parameter the complete collection is returned for compatibility.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | no | |
cursor | query | string | no | |
orgId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
items | object[] | yes | |
items.domainName | string | yes | |
items.status | "awaiting_ns" | "active" | yes | awaiting_ns: the zone is built and seeded by the provider's record scan — REVIEW its records (GET .../zones/:domainName/records; the scan finds common records, not necessarily all of them), add anything missing, then set the domain to `nameservers` at your registrar; active: the registry answers from the managed zone |
items.nameservers | string[] | yes | the managed zone's assigned nameservers — what the customer sets at their registrar |
items.delegated | boolean | yes | whether the domain's public nameservers answer from the managed zone, as of the platform's last periodic observation (about a minute); a domain pointed away after activation reads false again within the same window |
nextCursor | string | null | no |
400
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
403
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
503
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |