---
title: Search for available domains
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Registrar Sandbox](https://developers.cloudflare.com/api/resources/registrar_sandbox)
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.
**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
##### P ath ParametersExpand Collapse
account\_id: string
Identifier.
maxLength32
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Q uery 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
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(params)%20default%20%3E%20(param)%20q%20%3E%20(schema)>)
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.
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(params)%20default%20%3E%20(param)%20extensions%20%3E%20(schema)>)
limit: optional number
Maximum number of domain suggestions to return. Defaults to 20 if not specified.
maximum50
minimum1
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(params)%20default%20%3E%20(param)%20limit%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {code, message, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
source: optional object {pointer }
Location of the invalid value that caused the error.
pointer: string
JSON Pointer to the invalid or missing request value.
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
source: optional object {pointer }
Location of the invalid value that caused the error.
pointer: string
JSON Pointer to the invalid or missing request value.
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
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).
Link to this property
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.
Link to this property
pricing: optional object {currency, registration\_cost, renewal\_cost }
Provides annual pricing information for a given domain. The API returns all per-year prices as strings to preserve decimal precision.
renewal_cost and registration_cost or transfer_cost are frequently the same value, but may differ due to premium rates for certain domains.
For a multi-year operations, the operation’s cost applies to the first year and renewal_cost applies to each subsequent year. The values reflect the current registry rate, which can change over time.
currency: string
ISO-4217 currency code for the prices (e.g., “USD”, “EUR”, “GBP”).
Link to this property
registration\_cost: string
The first-year cost to register this domain.
Link to this property
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.
Link to this property
Link to this property
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"
Link to this property
"extension\_not\_supported"
Link to this property
"extension\_disallows\_registration"
Link to this property
"domain\_premium"
Link to this property
"domain\_unavailable"
Link to this property
Link to this property
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"
Link to this property
"premium"
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: true
Whether the API call was successful.
[Link to this property](<#(resource)%20registrar_sandbox%20%3E%20(method)%20search%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Search for available domains
HTTP
HTTPTypeScriptPythonGoTerraform
```
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
}
```