# Enumerate the connectable domains a provider credential controls

> Enumerate the connectable domains a provider credential controls: CustomDomain™ API reference. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/providers/listProviderZones

## `POST https://api.customdomain.ai/v1/providers/{provider}/zones:list`

For the bulk-connect picker. The credential is used once to list zones and is never persisted here. `422` (`list_not_supported`) when the adapter can't enumerate zones; the console degrades to single-domain connect.

### Authentication

`widgetJWT`

### Parameters

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

### Request body (JSON)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `credential` | object | yes |  |

### Responses

| Status | Description |
| --- | --- |
| `200` | Zones |
| `400` | Error envelope: {code, title, details}. |
| `401` | Error envelope: {code, title, details}. |
| `422` | The provider can't enumerate zones |
| `503` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | string | no |  |
| `zones` | array of string | no |  |

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