---
title: "Enumerate the connectable domains a provider credential controls"
method: POST
path: "/providers/{provider}/zones:list"
tags: ["Providers"]
---

# Enumerate the connectable domains a provider credential controls

`POST /providers/{provider}/zones:list`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/providers/{provider}/zones:list`
- Auth: HTTP bearer

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.

## Path parameters

- `provider` string, required

## Request body

- object
  - `credential` object, required
    - `token` string, required: Scoped provider API token; used once, never persisted.

## Response `200`

Zones

- object
  - `provider` string
  - `zones` string[]

## Other responses

- `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}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)