---
title: "Check one-click setup support for a domain (public)"
method: GET
path: "/public/domain-connect-check"
tags: ["Domains"]
---

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

`GET /public/domain-connect-check`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/public/domain-connect-check`
- Auth: none required

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 63-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.

## Query parameters

- `domain` string, required

## Response `200`

Detection result

- object
  - `domain` string, required: canonicalized hostname
  - `setup_type` 'automatic' | 'manual', required
  - `provider_id` string: census id of the detected provider
  - `provider_name` string
  - `rail` 'oauth' | 'api' | 'dc' | 'manual': census routing for the detected provider
  - `one_click` boolean, required: 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, required
    - `supported` boolean, required: the provider can complete a one-click Domain Connect setup of our template here
    - `sync` boolean, required
    - `async` boolean, required
    - `provider` string: provider name from DC discovery

## Other responses

- `400`: Error envelope: {code, title, details}.
- `429`: 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)