--- title: Search for available domains --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api) [Registrar Sandbox](https://developers.cloudflare.com/api/resources/registrar%5Fsandbox) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # Search for available domains GET/accounts/{account\_id}/registrar-sandbox/domain-search Searches for domain name suggestions based on a keyword, phrase, or partial domain name. Returns a list of potentially available domains with pricing information. **Important:** Results are non-authoritative and based on cached data. Always use the `/domain-check` endpoint to verify real-time availability before attempting registration. Suggestions are scoped to extensions supported for programmatic registration via this API (`POST /registrations`). Domains on unsupported extensions will not appear in results, even if they are available at the registry level. ### Use cases * Brand name discovery (e.g., “acme corp” → acmecorp.com, acmecorp.dev) * Keyword-based suggestions (e.g., “coffee shop” → coffeeshop.com, mycoffeeshop.net) * Alternative extension discovery (e.g., “example.com” → example.com, example.app, example.xyz) ### Workflow 1. Call this endpoint with a keyword or domain name. 2. Present suggestions to the user. 3. Call `/domain-check` with the user’s chosen domains to confirm real-time availability and pricing. 4. Proceed to `POST /registrations` only for supported non-premium domains where the Check response returns `registrable: true`. **Note:** Searching with just a domain extension (e.g., “com” or “.app”) is not supported. Provide a keyword or domain name. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Path ParametersExpand Collapse account\_id: string Identifier. maxLength32 ##### Query ParametersExpand Collapse q: string The search term to find domain suggestions. Accepts keywords, phrases, or full domain names. * Phrases: “coffee shop” returns coffeeshop.com, mycoffeeshop.net, etc. * Domain names: “example.com” returns example.com and variations across extensions maxLength100 minLength1 extensions: optional array of string Limits results to specific domain extensions from the supported set. If not specified, returns results across all supported extensions. Extensions not in the supported set are silently ignored. limit: optional number Maximum number of domain suggestions to return. Defaults to 20 if not specified. maximum50 minimum1 ##### ReturnsExpand Collapse errors: array of object { code, message, source } code: number minimum1000 message: string source: optional object { pointer } Location of the invalid value that caused the error. pointer: string JSON Pointer to the invalid or missing request value. messages: array of object { code, message, source } code: number minimum1000 message: string source: optional object { pointer } Location of the invalid value that caused the error. pointer: string JSON Pointer to the invalid or missing request value. result: object { domains } Contains the search results. domains: array of object { name, registrable, pricing, 2 more } Lists domain suggestions in relevance order. An empty array indicates that the search criteria matched zero domains. name: string The fully qualified domain name (FQDN) in punycode format for internationalized domain names (IDNs). registrable: boolean Indicates domain availability according to potentially stale, non-authoritative search data. * `true`: The domain appears available. Use POST /domain-check to confirm before registration. * `false`: Search results mark the domain ineligible for registration through this API. See `reason` for details. pricing: optional object { currency, registration\_cost, renewal\_cost } Provides annual pricing information for a registrable domain. This object appears only when `registrable` is `true`. The API returns all per-year prices as strings to preserve decimal precision. `registration_cost` and `renewal_cost` frequently have the same value, but may differ, especially when registries set different premium rates for initial registration and renewal. For a multi-year registration (e.g., 4 years), `registration_cost` applies to the first year and `renewal_cost`applies to each subsequent year. The values reflect the current registry rate, which may change over time. Search and Check may surface premium pricing, but this API currently supports standard registrations only. currency: string ISO-4217 currency code for the prices (e.g., “USD”, “EUR”, “GBP”). registration\_cost: string The first-year cost to register this domain. For premium domains (`tier: premium`), the registry sets this price, which may significantly exceed standard pricing. For multi-year registrations, this cost applies to the first year only; `renewal_cost` applies to subsequent years. renewal\_cost: string Per-year renewal cost for this domain. Applied to each year beyond the first year of a multi-year registration, and to each annual auto-renewal thereafter. May differ from `registration_cost`, especially for premium domains where initial registration often costs more than renewals. reason: optional "extension\_not\_supported\_via\_api" or "extension\_not\_supported" or "extension\_disallows\_registration" or 2 more Appears only when `registrable` is `false` and explains the advisory search result. Use POST /domain-check for authoritative status. * `extension_not_supported_via_api`: Cloudflare Registrar supports this extension in the dashboard but currently excludes it from programmatic registration through this API. * `extension_not_supported`: Cloudflare Registrar excludes this extension entirely. * `extension_disallows_registration`: The extension’s registry temporarily or permanently freezes new registrations. * `domain_premium`: The domain carries premium pricing. This API currently supports standard registrations only. * `domain_unavailable`: The domain appears unavailable. One of the following: "extension\_not\_supported\_via\_api" "extension\_not\_supported" "extension\_disallows\_registration" "domain\_premium" "domain\_unavailable" tier: optional "standard" or "premium" The pricing tier for this domain. A `registrable` value of `true` always includes this field, which defaults to `standard` for most domains. A `registrable` value of `false` may omit it. * `standard`: Standard registry pricing. * `premium`: Premium domain with higher pricing from the registry. One of the following: "standard" "premium" success: true Whether the API call was successful. ### Search for available domains HTTP HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar-sandbox/domain-search \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example 200 example 200 example 200 example 200 example 400 example 400 example ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "acmecorp.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "acmecorp.dev", "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }, "registrable": true, "tier": "standard" }, { "name": "acmecorp.app", "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "bestpizza.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "bestpizza.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" }, { "name": "bestpizzashop.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "coffeeshop.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "coffeeshoponline.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "mycoffeeshop.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" }, { "name": "thecoffeeshop.shop", "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "crypto.com", "pricing": { "currency": "USD", "registration_cost": "100000.00", "renewal_cost": "5000.00" }, "registrable": true, "tier": "premium" }, { "name": "cryptotrading.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "mycrypto.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [ { "code": 1002, "message": "Parameter q exceeds maximum length of 100 characters" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 1001, "message": "Missing required parameter: q" } ], "messages": [], "result": null, "success": false } ``` ##### Returns Examples 200 example 200 example 200 example 200 example 200 example 400 example 400 example ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "acmecorp.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "acmecorp.dev", "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }, "registrable": true, "tier": "standard" }, { "name": "acmecorp.app", "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "bestpizza.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "bestpizza.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" }, { "name": "bestpizzashop.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "coffeeshop.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "coffeeshoponline.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "mycoffeeshop.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" }, { "name": "thecoffeeshop.shop", "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [] }, "success": true } ``` ``` { "errors": [], "messages": [], "result": { "domains": [ { "name": "crypto.com", "pricing": { "currency": "USD", "registration_cost": "100000.00", "renewal_cost": "5000.00" }, "registrable": true, "tier": "premium" }, { "name": "cryptotrading.com", "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }, "registrable": true, "tier": "standard" }, { "name": "mycrypto.net", "pricing": { "currency": "USD", "registration_cost": "9.95", "renewal_cost": "9.95" }, "registrable": true, "tier": "standard" } ] }, "success": true } ``` ``` { "errors": [ { "code": 1002, "message": "Parameter q exceeds maximum length of 100 characters" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 1001, "message": "Missing required parameter: q" } ], "messages": [], "result": null, "success": false } ```