# The domains the account's key can reach

> The domains the account's key can reach: CustomDomain™ API reference in the provider accounts group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/provider-accounts/listProviderAccountZones

## `POST https://api.customdomain.ai/v1/provider-accounts/{id}/zones`

Lists the provider's domains with the kept key. `listed` is false for a provider that cannot list them. A refused key flags the account `needs_reconnect`. It takes an admin, an owner or the member who connected the account (`can_manage`), as connecting domains with it does; anyone else gets `403`. A one time account past its hour answers `409`, and its key is deleted then if the hourly cleanup has not deleted it yet. A key an end user's secure sign-in made in the widget answers `403`: it never lists the domains of the end user's account. The list is one read of the workspace's hourly budget of reach checks: once it is spent the call answers `429` `reach_quota` with `Retry-After` and asks the provider nothing.

### Authentication

`apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

### Responses

| Status | Description |
| --- | --- |
| `200` | The domains |
| `401` | Error envelope: {code, title, details}. |
| `403` | Error envelope: {code, title, details}. |
| `404` | Error envelope: {code, title, details}. |
| `409` | Error envelope: {code, title, details}. |
| `422` | The provider refused the key; the account is flagged `needs_reconnect` |
| `429` | `reach_quota`: the workspace has made as many reads at DNS providers, to find out what a key reaches, as it may this hour (the saved key resolver's reads, a key's reach check when its scope is widened, the list of a key's domains and Check now share one budget). Nothing was read at the provider, nothing changed and nothing was spent from the hour. `Retry-After` is the seconds until the hour ends, when the count starts again. |
| `503` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `zones` | array of string | no |  |
| `listed` | boolean | no |  |
| `message` | string | no |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
