# Check one-click setup support for a domain (public)

> Check one-click setup support for a domain (public): CustomDomain™ API reference. Covers request parameters, the request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/domains/publicDomainConnectCheck

## `GET https://api.customdomain.ai/v1/public/domain-connect-check`

Unauthenticated helper behind the free Domain Connect support checker tool. Answers whether a domain's DNS provider supports one-click setup: it runs the same detection cascade as the widget (Domain Connect discovery probed ahead of NS-pattern matching) and cross-references the provider census. Results are cached for 24 hours per domain and the endpoint is rate-limited per IP; do not build product flows on it. Use the authenticated `domains:check`, which carries records-aware conflict and apex verdicts.

### Authentication

None.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `domain` | query | string | yes | Hostname to check, e.g. example.com |

### Responses

| Status | Description |
| --- | --- |
| `200` | Detection result |
| `400` | Error envelope: {code, title, details}. |
| `429` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes | canonicalized hostname |
| `setup_type` | `automatic`, `manual` | yes |  |
| `provider_id` | string | no | census id of the detected provider |
| `provider_name` | string | no |  |
| `rail` | `oauth`, `api`, `dc`, `manual` | no | census routing for the detected provider |
| `one_click` | boolean | yes | true when the user only approves: an OAuth-routed provider, or a Domain Connect provider whose template check shows it holds our template |
| `domain_connect` | object | yes |  |
| `also_provider` | object | no | The second way, as `domains:check` names it: for a former Google Domains name `provider_id` is `squarespace` (the registrar) and this is `gcpdns`, whose nameservers it keeps. Absent otherwise. |

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