# List org zones

`GET https://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 |  |

## Response 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 |  |

## Response 400

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 403

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 404

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 503

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |